diff --git a/.env b/.env
index b7dd9e24f3..42c23ac87f 100644
--- a/.env
+++ b/.env
@@ -22,6 +22,7 @@ _APP_OPTIONS_FORCE_HTTPS=disabled
_APP_OPTIONS_ROUTER_FORCE_HTTPS=disabled
_APP_OPENSSL_KEY_V1=your-secret-key
_APP_DOMAIN=traefik
+_APP_CONSOLE_DOMAIN=localhost
_APP_DOMAIN_FUNCTIONS=functions.localhost
_APP_DOMAIN_SITES=sites.localhost
_APP_DOMAIN_TARGET_CNAME=test.localhost
diff --git a/.github/workflows/benchmark.yml b/.github/workflows/benchmark.yml
index 262c79ab3d..62b4953e27 100644
--- a/.github/workflows/benchmark.yml
+++ b/.github/workflows/benchmark.yml
@@ -64,8 +64,9 @@ jobs:
sudo wget -O /usr/share/keyrings/azlux-archive-keyring.gpg https://azlux.fr/repo.gpg
sudo apt update
sudo apt install oha
+ oha --version
- name: Benchmark PR
- run: 'oha -z 180s http://localhost/v1/health/version --output-format json --output benchmark.json'
+ run: 'oha -z 180s http://localhost/v1/health/version --output-format json > benchmark.json'
- name: Cleaning
run: docker compose down -v
- name: Installing latest version
@@ -78,7 +79,7 @@ jobs:
docker compose up -d
sleep 10
- name: Benchmark Latest
- run: 'oha -z 180s http://localhost/v1/health/version --output-format json --output benchmark-latest.json'
+ run: oha -z 180s http://localhost/v1/health/version --output-format json > benchmark-latest.json
- name: Prepare comment
run: |
echo '## :sparkles: Benchmark results' > benchmark.txt
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 97f3696e67..f363372009 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -145,7 +145,8 @@ jobs:
Account,
Avatars,
Console,
- Databases,
+ Databases/Legacy,
+ Databases/Tables,
Functions,
FunctionsSchedule,
GraphQL,
@@ -213,7 +214,8 @@ jobs:
Account,
Avatars,
Console,
- Databases,
+ Databases/Legacy,
+ Databases/Tables,
Functions,
FunctionsSchedule,
GraphQL,
@@ -283,8 +285,6 @@ jobs:
name: E2E Service Test (Dev Keys)
runs-on: ubuntu-latest
needs: setup
- strategy:
- fail-fast: false
steps:
- name: checkout
uses: actions/checkout@v4
diff --git a/app/cli.php b/app/cli.php
index c829546011..86ec241c93 100644
--- a/app/cli.php
+++ b/app/cli.php
@@ -188,16 +188,18 @@ CLI::setResource('getLogsDB', function (Group $pools, Cache $cache) {
return $database;
};
}, ['pools', 'cache']);
-
+CLI::setResource('publisher', function (Group $pools) {
+ return new BrokerPool(publisher: $pools->get('publisher'));
+}, ['pools']);
+CLI::setResource('publisherRedis', function () {
+ // Stub
+});
CLI::setResource('queueForStatsUsage', function (Publisher $publisher) {
return new StatsUsage($publisher);
}, ['publisher']);
CLI::setResource('queueForStatsResources', function (Publisher $publisher) {
return new StatsResources($publisher);
}, ['publisher']);
-CLI::setResource('publisher', function (Group $pools) {
- return new BrokerPool(publisher: $pools->get('publisher'));
-}, ['pools']);
CLI::setResource('queueForFunctions', function (Publisher $publisher) {
return new Func($publisher);
}, ['publisher']);
diff --git a/app/config/console.php b/app/config/console.php
index aa7de13ba0..faacecaa08 100644
--- a/app/config/console.php
+++ b/app/config/console.php
@@ -5,7 +5,7 @@
*/
use Appwrite\Auth\Auth;
-use Appwrite\Network\Validator\Origin;
+use Appwrite\Network\Platform;
use Utopia\Database\Helpers\ID;
use Utopia\System\System;
@@ -23,7 +23,7 @@ $console = [
[
'$collection' => ID::custom('platforms'),
'name' => 'Localhost',
- 'type' => Origin::CLIENT_TYPE_WEB,
+ 'type' => Platform::TYPE_WEB,
'hostname' => 'localhost',
], // Current host is added on app init
],
diff --git a/app/config/errors.php b/app/config/errors.php
index 8365e8c705..23df60f4ba 100644
--- a/app/config/errors.php
+++ b/app/config/errors.php
@@ -69,9 +69,14 @@ return [
'description' => 'The request contains one or more invalid arguments. Please refer to the endpoint documentation.',
'code' => 400,
],
- Exception::GENERAL_QUERY_LIMIT_EXCEEDED => [
- 'name' => Exception::GENERAL_QUERY_LIMIT_EXCEEDED,
- 'description' => 'Query limit exceeded for the current attribute. Usage of more than 100 query values on a single attribute is prohibited.',
+ Exception::GENERAL_ATTRIBUTE_QUERY_LIMIT_EXCEEDED => [
+ 'name' => Exception::GENERAL_ATTRIBUTE_QUERY_LIMIT_EXCEEDED,
+ 'description' => 'Query limit exceeded for the current attribute.',
+ 'code' => 400,
+ ],
+ Exception::GENERAL_COLUMN_QUERY_LIMIT_EXCEEDED => [
+ 'name' => Exception::GENERAL_COLUMN_QUERY_LIMIT_EXCEEDED,
+ 'description' => 'Query limit exceeded for the current column.',
'code' => 400,
],
Exception::GENERAL_QUERY_INVALID => [
@@ -668,7 +673,7 @@ return [
],
Exception::DATABASE_QUERY_ORDER_NULL => [
'name' => Exception::DATABASE_QUERY_ORDER_NULL,
- 'description' => 'The order attribute had a null value. Cursor pagination requires all documents order attribute values are non-null.',
+ 'description' => 'The order attribute/column had a null value. Cursor pagination requires all documents/rows order attribute/column values are non-null.',
'code' => 400,
],
@@ -689,6 +694,23 @@ return [
'code' => 400,
],
+ /** Tables */
+ Exception::TABLE_NOT_FOUND => [
+ 'name' => Exception::TABLE_NOT_FOUND,
+ 'description' => 'Table with the requested ID could not be found.',
+ 'code' => 404,
+ ],
+ Exception::TABLE_ALREADY_EXISTS => [
+ 'name' => Exception::TABLE_ALREADY_EXISTS,
+ 'description' => 'A table with the requested ID already exists. Try again with a different ID or use ID.unique() to generate a unique ID.',
+ 'code' => 409,
+ ],
+ Exception::TABLE_LIMIT_EXCEEDED => [
+ 'name' => Exception::TABLE_LIMIT_EXCEEDED,
+ 'description' => 'The maximum number of tables has been reached.',
+ 'code' => 400,
+ ],
+
/** Documents */
Exception::DOCUMENT_NOT_FOUND => [
'name' => Exception::DOCUMENT_NOT_FOUND,
@@ -726,6 +748,43 @@ return [
'code' => 403,
],
+ /** Rows */
+ Exception::ROW_NOT_FOUND => [
+ 'name' => Exception::ROW_NOT_FOUND,
+ 'description' => 'Row with the requested ID could not be found.',
+ 'code' => 404,
+ ],
+ Exception::ROW_INVALID_STRUCTURE => [
+ 'name' => Exception::ROW_INVALID_STRUCTURE,
+ 'description' => 'The row structure is invalid. Please ensure the columns match the table definition.',
+ 'code' => 400,
+ ],
+ Exception::ROW_MISSING_DATA => [
+ 'name' => Exception::ROW_MISSING_DATA,
+ 'description' => 'The row data is missing. Try again with row data populated',
+ 'code' => 400,
+ ],
+ Exception::ROW_MISSING_PAYLOAD => [
+ 'name' => Exception::ROW_MISSING_PAYLOAD,
+ 'description' => 'The row data and permissions are missing. You must provide either row data or permissions to be updated.',
+ 'code' => 400,
+ ],
+ Exception::ROW_ALREADY_EXISTS => [
+ 'name' => Exception::ROW_ALREADY_EXISTS,
+ 'description' => 'Row with the requested ID already exists. Try again with a different ID or use ID.unique() to generate a unique ID.',
+ 'code' => 409,
+ ],
+ Exception::ROW_UPDATE_CONFLICT => [
+ 'name' => Exception::ROW_UPDATE_CONFLICT,
+ 'description' => 'Remote row is newer than local.',
+ 'code' => 409,
+ ],
+ Exception::ROW_DELETE_RESTRICTED => [
+ 'name' => Exception::ROW_DELETE_RESTRICTED,
+ 'description' => 'Row cannot be deleted because it is referenced by another row.',
+ 'code' => 403,
+ ],
+
/** Attributes */
Exception::ATTRIBUTE_NOT_FOUND => [
'name' => Exception::ATTRIBUTE_NOT_FOUND,
@@ -772,13 +831,67 @@ return [
'description' => 'The attribute type is invalid.',
'code' => 400,
],
+ Exception::ATTRIBUTE_INVALID_RESIZE => [
+ 'name' => Exception::ATTRIBUTE_INVALID_RESIZE,
+ 'description' => 'Existing data is too large for new size, truncate your existing data then try again.',
+ 'code' => 400,
+ ],
+
+ /** Exists for both Attributes & Columns */
Exception::RELATIONSHIP_VALUE_INVALID => [
'name' => Exception::RELATIONSHIP_VALUE_INVALID,
'description' => 'The relationship value is invalid.',
'code' => 400,
],
- Exception::ATTRIBUTE_INVALID_RESIZE => [
- 'name' => Exception::ATTRIBUTE_INVALID_RESIZE,
+
+ /** Columns */
+ Exception::COLUMN_NOT_FOUND => [
+ 'name' => Exception::COLUMN_NOT_FOUND,
+ 'description' => 'Column with the requested ID could not be found.',
+ 'code' => 404,
+ ],
+ Exception::COLUMN_UNKNOWN => [
+ 'name' => Exception::COLUMN_UNKNOWN,
+ 'description' => 'The column required for the index could not be found. Please confirm all your columns are in the available state.',
+ 'code' => 400,
+ ],
+ Exception::COLUMN_NOT_AVAILABLE => [
+ 'name' => Exception::COLUMN_NOT_AVAILABLE,
+ 'description' => 'The requested column is not yet available. Please try again later.',
+ 'code' => 400,
+ ],
+ Exception::COLUMN_FORMAT_UNSUPPORTED => [
+ 'name' => Exception::COLUMN_FORMAT_UNSUPPORTED,
+ 'description' => 'The requested column format is not supported.',
+ 'code' => 400,
+ ],
+ Exception::COLUMN_DEFAULT_UNSUPPORTED => [
+ 'name' => Exception::COLUMN_DEFAULT_UNSUPPORTED,
+ 'description' => 'Default values cannot be set for array or required columns.',
+ 'code' => 400,
+ ],
+ Exception::COLUMN_ALREADY_EXISTS => [
+ 'name' => Exception::COLUMN_ALREADY_EXISTS,
+ 'description' => 'Column with the requested key already exists. Column keys must be unique, try again with a different key.',
+ 'code' => 409,
+ ],
+ Exception::COLUMN_LIMIT_EXCEEDED => [
+ 'name' => Exception::COLUMN_LIMIT_EXCEEDED,
+ 'description' => 'The maximum number or size of columns for this table has been reached.',
+ 'code' => 400,
+ ],
+ Exception::COLUMN_VALUE_INVALID => [
+ 'name' => Exception::COLUMN_VALUE_INVALID,
+ 'description' => 'The column value is invalid. Please check the type, range and value of the column.',
+ 'code' => 400,
+ ],
+ Exception::COLUMN_TYPE_INVALID => [
+ 'name' => Exception::COLUMN_TYPE_INVALID,
+ 'description' => 'The column type is invalid.',
+ 'code' => 400,
+ ],
+ Exception::COLUMN_INVALID_RESIZE => [
+ 'name' => Exception::COLUMN_INVALID_RESIZE,
'description' => "Existing data is too large for new size, truncate your existing data then try again.",
'code' => 400,
],
@@ -810,6 +923,33 @@ return [
'code' => 409,
],
+ /** Column Indexes, same as Indexes but with different type */
+ Exception::COLUMN_INDEX_NOT_FOUND => [
+ 'name' => Exception::COLUMN_INDEX_NOT_FOUND,
+ 'description' => 'Index with the requested ID could not be found.',
+ 'code' => 404,
+ ],
+ Exception::COLUMN_INDEX_LIMIT_EXCEEDED => [
+ 'name' => Exception::COLUMN_INDEX_LIMIT_EXCEEDED,
+ 'description' => 'The maximum number of indexes has been reached.',
+ 'code' => 400,
+ ],
+ Exception::COLUMN_INDEX_ALREADY_EXISTS => [
+ 'name' => Exception::COLUMN_INDEX_ALREADY_EXISTS,
+ 'description' => 'Index with the requested key already exists. Try again with a different key.',
+ 'code' => 409,
+ ],
+ Exception::COLUMN_INDEX_INVALID => [
+ 'name' => Exception::COLUMN_INDEX_INVALID,
+ 'description' => 'Index invalid.',
+ 'code' => 400,
+ ],
+ Exception::COLUMN_INDEX_DEPENDENCY => [
+ 'name' => Exception::COLUMN_INDEX_DEPENDENCY,
+ 'description' => 'Column cannot be renamed or deleted. Please remove the associated index first.',
+ 'code' => 409,
+ ],
+
/** Project Errors */
Exception::PROJECT_NOT_FOUND => [
'name' => Exception::PROJECT_NOT_FOUND,
diff --git a/app/config/events.php b/app/config/events.php
index 0bfddf4f1f..8e759aaf56 100644
--- a/app/config/events.php
+++ b/app/config/events.php
@@ -95,6 +95,56 @@ return [
'$model' => Response::MODEL_DATABASE,
'$resource' => true,
'$description' => 'This event triggers on any database event.',
+ 'tables' => [
+ '$model' => Response::MODEL_TABLE,
+ '$resource' => true,
+ '$description' => 'This event triggers on any table event.',
+ 'rows' => [
+ '$model' => Response::MODEL_ROW,
+ '$resource' => true,
+ '$description' => 'This event triggers on any rows event.',
+ 'create' => [
+ '$description' => 'This event triggers when a row is created.',
+ ],
+ 'delete' => [
+ '$description' => 'This event triggers when a row is deleted.'
+ ],
+ 'update' => [
+ '$description' => 'This event triggers when a row is updated.'
+ ],
+ ],
+ 'indexes' => [
+ '$model' => Response::MODEL_COLUMN_INDEX,
+ '$resource' => true,
+ '$description' => 'This event triggers on any indexes event.',
+ 'create' => [
+ '$description' => 'This event triggers when an index is created.',
+ ],
+ 'delete' => [
+ '$description' => 'This event triggers when an index is deleted.'
+ ]
+ ],
+ 'columns' => [
+ '$model' => Response::MODEL_COLUMN,
+ '$resource' => true,
+ '$description' => 'This event triggers on any columns event.',
+ 'create' => [
+ '$description' => 'This event triggers when a column is created.',
+ ],
+ 'delete' => [
+ '$description' => 'This event triggers when an column is deleted.'
+ ]
+ ],
+ 'create' => [
+ '$description' => 'This event triggers when a table is created.'
+ ],
+ 'delete' => [
+ '$description' => 'This event triggers when a table is deleted.',
+ ],
+ 'update' => [
+ '$description' => 'This event triggers when a table is updated.',
+ ]
+ ],
'collections' => [
'$model' => Response::MODEL_COLLECTION,
'$resource' => true,
diff --git a/app/config/locale/templates/email-inner-base.tpl b/app/config/locale/templates/email-inner-base.tpl
index 8cef391d2f..677f70ce7d 100644
--- a/app/config/locale/templates/email-inner-base.tpl
+++ b/app/config/locale/templates/email-inner-base.tpl
@@ -1,6 +1,6 @@
{{hello}}
{{body}}
-{{redirect}}
+{{buttonText}}
{{footer}}
{{thanks}}
diff --git a/app/config/locale/translations/af.json b/app/config/locale/translations/af.json
index e68fda2c75..9b313ac92a 100644
--- a/app/config/locale/translations/af.json
+++ b/app/config/locale/translations/af.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Volg hierdie skakel om u e-pos adres te bevestig.",
"emails.verification.footer": "Ignoreer gerus hierdie boodskap as u nie die versoek gestuur het om u adres te bevestig nie.",
"emails.verification.thanks": "Baie dankie,",
+ "emails.verification.buttonText": "Bevestig e-posadres",
"emails.verification.signature": "Die {{project}} span",
"emails.magicSession.subject": "Teken aan",
"emails.magicSession.hello": "Goeie dag,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Volg hierdie skakel om u {{project}} wagwoord te herstel.",
"emails.recovery.footer": "Ignoreer gerus hierdie boodskap as u nie die versoek gestuur het om u wagwoord te herstel nie.",
"emails.recovery.thanks": "Baie dankie,",
+ "emails.recovery.buttonText": "Stel wagwoord terug",
"emails.recovery.signature": "Die {{project}} span",
"emails.invitation.subject": "Uitnodiging om by die %s span aan te sluit by %s",
"emails.invitation.hello": "Goeie dag,",
"emails.invitation.body": "Hierdie boodskap is aan u gestuur omdat {{owner}} u uitnooi om 'n lid van die {{team}} groep by die {{project}} projek te wees.",
"emails.invitation.footer": "As u nie belang stel nie, kan u gerus hierdie boodskap ignoreer.",
"emails.invitation.thanks": "Baie dankie,",
+ "emails.invitation.buttonText": "Aanvaar uitnodiging na {{team}}",
"emails.invitation.signature": "Die {{project}} span",
"locale.country.unknown": "Onbekend",
"countries.af": "Afghanistan",
diff --git a/app/config/locale/translations/ar-ma.json b/app/config/locale/translations/ar-ma.json
index efd2e95c31..e4b5b1f558 100644
--- a/app/config/locale/translations/ar-ma.json
+++ b/app/config/locale/translations/ar-ma.json
@@ -8,6 +8,7 @@
"emails.verification.body": "تبّع هاد الوصلة باش تيقّن لادريسة تاع ليميل ديالك.",
"emails.verification.footer": "إلا ماشي نتا اللي طلبتي تيقّن هاد لادريسة تاع ليميل، ممكن تنخّل هاد البرية.",
"emails.verification.thanks": "شكرا،",
+ "emails.verification.buttonText": "تأكيد عنوان البريد الإلكتروني",
"emails.verification.signature": "فرقة {{project}}",
"emails.magicSession.subject": "تكونيكطا",
"emails.magicSession.hello": "السلام،",
@@ -20,12 +21,14 @@
"emails.recovery.body": "تبّع هاد الوصلة باش تبدّل كلمة السر تاع {{project}}.",
"emails.recovery.footer": "إلا ماشي نتا اللي طلبتي تبدّل كلمة السر، ممكن تنخّل هاد البرية.",
"emails.recovery.thanks": "شكرا،",
+ "emails.recovery.buttonText": "إعادة تعيين كلمة السر",
"emails.recovery.signature": "فرقة {{project}}",
"emails.invitation.subject": "عراضة ل فرقة %s ف %s",
"emails.invitation.hello": "السلام،",
"emails.invitation.body": "هاد البرية تصيفطات ليك حيت {{owner}} بغى يعرض عليك تولّي عضو ف فرقة {{team}} عند {{project}}.",
"emails.invitation.footer": "إلا كنتي ما مسوّقش, ممكن تنخّل هاد البرية.",
"emails.invitation.thanks": "شكرا،",
+ "emails.invitation.buttonText": "اقبل الدعوة إلى {{team}}",
"emails.invitation.signature": "فرقة {{project}}",
"emails.certificate.subject": "السرتافيكة فشلات ل %s",
"emails.certificate.hello": "السلام،",
diff --git a/app/config/locale/translations/ar.json b/app/config/locale/translations/ar.json
index 1d67c2ecf7..eda0652fbe 100644
--- a/app/config/locale/translations/ar.json
+++ b/app/config/locale/translations/ar.json
@@ -8,6 +8,7 @@
"emails.verification.body": "برجاء اتباع الرابط التالي لتأكيد بريدك الإلكتروني",
"emails.verification.footer": "لو لم تطلب تأكيد هذا البريد الإلكتروني، يمكنك تجاهل هذه الرسالة",
"emails.verification.thanks": "شكرا،",
+ "emails.verification.buttonText": "تأكيد عنوان البريد الإلكتروني",
"emails.verification.signature": "فريق {{project}}",
"emails.magicSession.subject": "تسجيل الدخول",
"emails.magicSession.hello": "أهلا،",
@@ -20,12 +21,14 @@
"emails.recovery.body": "برجاء اتباع الراط التالي لتغيير كلمة السر الخاصة بـ{{project}}",
"emails.recovery.footer": "لولم تطلب تغيير كلمة السر، يمكنك تجاهل هذه الرسالة",
"emails.recovery.thanks": "شكرا،",
+ "emails.recovery.buttonText": "إعادة تعيين كلمة المرور",
"emails.recovery.signature": "فريق {{project}}",
"emails.invitation.subject": "دعوة لفريق %s في %s",
"emails.invitation.hello": "أهلا،",
"emails.invitation.body": "هذة الرسالة تم ارسالها لك لأن {{owner}} ارسل لك دعوة لتكون عضوا بفريق {{team}} في {{project}}",
"emails.invitation.footer": "اذا كنت غير مهتم، يمكنك تجاهل هذه الرسالة",
"emails.invitation.thanks": "شكرا،",
+ "emails.invitation.buttonText": "قبول الدعوة إلى {{team}}",
"emails.invitation.signature": "فريق {{project}}",
"locale.country.unknown": "مجهول",
"countries.af": "أفغانستان",
diff --git a/app/config/locale/translations/as.json b/app/config/locale/translations/as.json
index 572ed80f1a..60e385a8ac 100644
--- a/app/config/locale/translations/as.json
+++ b/app/config/locale/translations/as.json
@@ -8,6 +8,7 @@
"emails.verification.body": "আপোনাৰ ইমেইল ঠিকনা প্ৰমাণিত কৰিবলৈ এই লিংকটো অনুসৰণ কৰক।",
"emails.verification.footer": "যদি আপুনি এই ঠিকনাটো সত্যাপিত কৰিবলৈ কোৱা নাই, আপুনি এই বাৰ্তাটো উপেক্ষা কৰিব পাৰে।",
"emails.verification.thanks": "ধন্যবাদ,",
+ "emails.verification.buttonText": "ইমেইল ঠিকনা নিশ্চিত কৰক",
"emails.verification.signature": "{{project}} দল",
"emails.magicSession.subject": "লগইন",
"emails.magicSession.hello": "নমস্কাৰ,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "আপোনাৰ {{project}} পাছৱৰ্ড ৰিছেট কৰিবলৈ এই লিংকটো অনুসৰণ কৰক।.",
"emails.recovery.footer": "যদি আপুনি আপোনাৰ পাছৱৰ্ড ৰিছেট কৰিবলৈ কোৱা নাছিল, আপুনি এই বাৰ্তাটো উপেক্ষা কৰিব পাৰে।",
"emails.recovery.thanks": "ধন্যবাদ,",
+ "emails.recovery.buttonText": "পাছৱৰ্ড ৰিছেট কৰক",
"emails.recovery.signature": "{{project}} দল",
"emails.invitation.subject": "%s বছৰত %s দললৈ নিমন্ত্ৰণ",
"emails.invitation.hello": "নমস্কাৰ,",
"emails.invitation.body": "এই মেইলটো আপোনালৈ প্ৰেৰণ কৰা হৈছিল কাৰণ {{owner}} জনে আপোনাক {{project}} বছৰবয়সত {{team}} দলৰ সদস্য হ'বলৈ আমন্ত্ৰণ জনাব বিচাৰিছিল।",
"emails.invitation.footer": "যদি আপুনি আগ্ৰহী নহয়, আপুনি এই বাৰ্তাটো উপেক্ষা কৰিব পাৰে।",
"emails.invitation.thanks": "ধন্যবাদ,",
+ "emails.invitation.buttonText": "{{team}}-লৈ নিমন্ত্ৰণ গ্ৰহণ কৰক",
"emails.invitation.signature": "{{project}} দল",
"locale.country.unknown": "অজ্ঞাত ",
"countries.af": "আফগানিস্তান ",
diff --git a/app/config/locale/translations/az.json b/app/config/locale/translations/az.json
index 5988c51786..63e442f7c5 100644
--- a/app/config/locale/translations/az.json
+++ b/app/config/locale/translations/az.json
@@ -8,6 +8,7 @@
"emails.verification.body": "E-poçt ünvanınızı təsdiq etmək üçün bu linki izləyin.",
"emails.verification.footer": "Bu ünvanı doğrulamağı xahiş etməmisinizsə, bu mesajı gözardı edə bilərsiniz.",
"emails.verification.thanks": "Təşəkkürlər,",
+ "emails.verification.buttonText": "E-poçt ünvanını təsdiqlə",
"emails.verification.signature": "{{project}} komandası",
"emails.magicSession.subject": "Daxil Olmaq",
"emails.magicSession.hello": "Salam,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "{{project}} şifrənizi sıfırlamaq üçün bu linki izləyin.",
"emails.recovery.footer": "Şifrənizi sıfırlamağı xahiş etməmisinizsə, bu mesajı gözardı edə bilərsiniz.",
"emails.recovery.thanks": "Təşəkkürlər,",
+ "emails.recovery.buttonText": "Şifrəni sıfırla",
"emails.recovery.signature": "{{project}} komandası",
"emails.invitation.subject": "%s Komandasına Dəvət %sdə",
"emails.invitation.hello": "Salam,",
"emails.invitation.body": "{{owner}}, {{project}}də {{team}} komandasına üzv olmağa dəvət etmək istədiyi üçün bu məktub sizə göndərildi.",
"emails.invitation.footer": "Əgər maraqlanmırsınızsa, bu mesajı gözardı edə bilərsiniz.",
"emails.invitation.thanks": "Təşəkkürlər,",
+ "emails.invitation.buttonText": "{{team}} dəvətini qəbul et",
"emails.invitation.signature": "{{project}} komandası",
"locale.country.unknown": "Naməlum",
"countries.af": "Əfqanıstan",
diff --git a/app/config/locale/translations/be.json b/app/config/locale/translations/be.json
index f03a9d5bef..b4ae0827c3 100644
--- a/app/config/locale/translations/be.json
+++ b/app/config/locale/translations/be.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Перайдзіце па гэтай спасылцы, каб пацвердзіць свой адрас электроннай пошты",
"emails.verification.footer": "Калі вы не запытвалі пацвярджэнне гэтага адрасу, праігнаруйце гэтае паведамленне.",
"emails.verification.thanks": "Дзякуем,",
+ "emails.verification.buttonText": "Пацвердзіць адрас электроннай пошты",
"emails.verification.signature": "каманда {{project}}",
"emails.magicSession.subject": "Лагін",
"emails.magicSession.hello": "Прывітанне,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Перайдзіце па гэтай спасылцы, каб скінуць пароль для праекта {{project}}.",
"emails.recovery.footer": "Калі вы не прасілі скінуць пароль, вы можаце праігнараваць гэта паведамленне.",
"emails.recovery.thanks": "Дзякуем,",
+ "emails.recovery.buttonText": "Аднавіць пароль",
"emails.recovery.signature": "каманда {{project}}",
"emails.invitation.subject": "Запрошення до Команди %s у %s",
"emails.invitation.hello": "Прывітанне,",
"emails.invitation.body": "Гэта паведамленне было адпраўлена вам, таму што {{owner}} хацеў запрасіць вас стаць членам каманды {{team}} у {{project}}.",
"emails.invitation.footer": "Калі вам гэта не цікава, вы можаце праігнараваць гэтае паведамленне.",
"emails.invitation.thanks": "Дзякуем,",
+ "emails.invitation.buttonText": "Прыняць запрашэнне ў {{team}}",
"emails.invitation.signature": "каманда {{project}}",
"locale.country.unknown": "Невядомы",
"countries.af": "Афганістан",
diff --git a/app/config/locale/translations/bh.json b/app/config/locale/translations/bh.json
index 5cf06bd1dd..7d2b469ed5 100644
--- a/app/config/locale/translations/bh.json
+++ b/app/config/locale/translations/bh.json
@@ -8,6 +8,7 @@
"emails.verification.body": "ईमेल प्रमाणिकरण करे क लेल दिहल गइल लिंक फॉलो करें|",
"emails.verification.footer": "अगर ई पता को सत्यापित करे के लिए ना कहाले, तो आप ई संदेश क अनदेखा कर सकत अछि।",
"emails.verification.thanks": "धन्यवाद,",
+ "emails.verification.buttonText": "ईमेल पता के पुष्टि करीं",
"emails.verification.signature": "{{project}} टीम",
"emails.magicSession.subject": "लॉग इन करीं|",
"emails.magicSession.hello": "प्रणाम,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "पासवर्ड बदल क लेल दिहल गइल लिंक फॉलो करें|",
"emails.recovery.footer": "अगर पासवर्ड बदल क लेल ना कहाले, तो आप ई संदेश क अनदेखा कर सकत अछि।",
"emails.recovery.thanks": "धन्यवाद,",
+ "emails.recovery.buttonText": "पासवर्ड रीसेट करीं",
"emails.recovery.signature": "{{project}} टीम",
"emails.invitation.subject": "%s टीम क %s पे न्योता देवे क लेल|",
"emails.invitation.hello": "प्रणाम,",
"emails.invitation.body": "ई मेल आपके एही लेल भेजल गईल रहल काहे क {{owner}} आपके {{project}} क {{team}} टीम का सदस्य बनावे चाहित रहे|",
"emails.invitation.footer": "अगर आवे क इच्छा ना होवत, तो आप ई संदेश क अनदेखा कर सकत अछि।",
"emails.invitation.thanks": "धन्यवाद,",
+ "emails.invitation.buttonText": "{{team}} में नेवता स्वीकार करीं",
"emails.invitation.signature": "{{project}} टीम",
"locale.country.unknown": "अनजान",
"countries.af": "अफ़ग़ानिस्तान",
diff --git a/app/config/locale/translations/bn.json b/app/config/locale/translations/bn.json
index 495f56e012..1157d5cc0f 100644
--- a/app/config/locale/translations/bn.json
+++ b/app/config/locale/translations/bn.json
@@ -8,6 +8,7 @@
"emails.verification.body": "এই লিঙ্কের মাধ্যমে ইমেইল যাচাই করুন।",
"emails.verification.footer": "আপনি যদি এই ঠিকানা যাচাই করতে না বলেন, তাহলে আপনি এই বার্তাটি উপেক্ষা করতে পারেন।",
"emails.verification.thanks": "ধন্যবাদ,",
+ "emails.verification.buttonText": "ইমেইল ঠিকানা নিশ্চিত করুন",
"emails.verification.signature": "{{project}} টীম",
"emails.magicSession.subject": "লগ ইন",
"emails.magicSession.hello": "নমস্কার,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "এই লিঙ্কের মাধ্যমে আপনার {{project}} পাসওয়ার্ড পুনরায় সেট করুন।",
"emails.recovery.footer": "আপনি যদি আপনার পাসওয়ার্ড পুনরায় সেট করতে না বলেন, তাহলে আপনি এই বার্তাটি উপেক্ষা করতে পারেন।",
"emails.recovery.thanks": "ধন্যবাদ,",
+ "emails.recovery.buttonText": "পাসওয়ার্ড রিসেট করুন",
"emails.recovery.signature": "{{project}} টীম",
"emails.invitation.subject": "%s টিমকে %s তে আমন্ত্রণ জানান",
"emails.invitation.hello": "নমস্কার,",
"emails.invitation.body": "এই মেইলটি আপনাকে পাঠানো হয়েছে কারণ {{owner}} আপনাকে {{project}} এর সাথে যুক্ত {{team}} টিমের সদস্য হওয়ার জন্য আমন্ত্রণ জানাতে চেয়েছিলেন।",
"emails.invitation.footer": "যদি এটি আপনার জন্য প্রয়োজনীয় না হয়, আপনি এই বার্তাটি উপেক্ষা করতে পারেন।",
"emails.invitation.thanks": "ধন্যবাদ,",
+ "emails.invitation.buttonText": "{{team}}-এর আমন্ত্রণ গ্রহণ করুন",
"emails.invitation.signature": "{{project}} টীম",
"locale.country.unknown": "অজানা",
"countries.af": "আফগানিস্তান",
diff --git a/app/config/locale/translations/ca.json b/app/config/locale/translations/ca.json
index 98940a4a48..ec5112f075 100644
--- a/app/config/locale/translations/ca.json
+++ b/app/config/locale/translations/ca.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Accedeix a aquest enllaç per tal de verificar la teva adreça electrònica.",
"emails.verification.footer": "Si no has sol·licitat la verificació d'aquesta adreça electrònica, pots ignorar aquest missatge.",
"emails.verification.thanks": "Gràcies,",
+ "emails.verification.buttonText": "Confirma l'adreça electrònica",
"emails.verification.signature": "Equip {{project}}",
"emails.magicSession.subject": "Entrar",
"emails.magicSession.hello": "Hola,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Accedeix a aquest enllaç per a reinicialitzar la teva contrasenya de {{project}}.",
"emails.recovery.footer": "Si no has sol·licitat reinicialitzar la teva contrasenya, pots ignorar aquest missatge.",
"emails.recovery.thanks": "Gràcies,",
+ "emails.recovery.buttonText": "Restableix la contrasenya",
"emails.recovery.signature": "Equip {{project}}",
"emails.invitation.subject": "Invitació a l'equip %s a s%",
"emails.invitation.hello": "Hola,",
"emails.invitation.body": "Aquest correu se t'ha enviat perquè {{owner}} vol convidar-te a formar part de l'equip {{team}} al {{project}}.",
"emails.invitation.footer": "Si no és del teu interès, pots ignorar aquest missatge.",
"emails.invitation.thanks": "Gràcies,",
+ "emails.invitation.buttonText": "Accepta la invitació a {{team}}",
"emails.invitation.signature": "Equip {{project}}",
"locale.country.unknown": "Desconegut",
"countries.af": "Afganistan",
diff --git a/app/config/locale/translations/da.json b/app/config/locale/translations/da.json
index 9cec74dbed..ae93b3c3b5 100644
--- a/app/config/locale/translations/da.json
+++ b/app/config/locale/translations/da.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Følg dette link, for at verificere din email adresse.",
"emails.verification.footer": "Hvis du ikke har bedt om at verificere denne adresse, ignorer venligst denne besked.",
"emails.verification.thanks": "Tak,",
+ "emails.verification.buttonText": "Bekræft e-mailadresse",
"emails.verification.signature": "{{project}} team",
"emails.magicSession.subject": "Login",
"emails.magicSession.hello": "Hej,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Følg dette link for at nulstille koden til {{project}}.",
"emails.recovery.footer": "Hvis du ikke har bedt om at nulstille dit password, ignorer venligst denne besked.",
"emails.recovery.thanks": "Tak,",
+ "emails.recovery.buttonText": "Nulstil adgangskode",
"emails.recovery.signature": "{{project}} team",
"emails.invitation.subject": "Invitation til %s Team på %s",
"emails.invitation.hello": "Hej,",
"emails.invitation.body": "Denne mail blev sendt til dig, fordi {{owner}} vil invitere dig til at blive medlem af {{team}} teamet på {{project}}.",
"emails.invitation.footer": "Hvis du ikke er interesseret, ignorer venligst denne besked.",
"emails.invitation.thanks": "Tak,",
+ "emails.invitation.buttonText": "Accepter invitation til {{team}}",
"emails.invitation.signature": "{{project}} team",
"locale.country.unknown": "Ukendt",
"countries.af": "Afghanistan",
diff --git a/app/config/locale/translations/de.json b/app/config/locale/translations/de.json
index 38b1e46870..a5a2f0ba43 100644
--- a/app/config/locale/translations/de.json
+++ b/app/config/locale/translations/de.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Folge diesem Link, um deine E-Mail-Adresse zu bestätigen.",
"emails.verification.footer": "Solltest du keine Verifizierung dieser E-Mail-Adresse angefordert haben, kannst du diese Nachricht ignorieren.",
"emails.verification.thanks": "Danke,",
+ "emails.verification.buttonText": "E-Mail-Adresse bestätigen",
"emails.verification.signature": "{{project}}-Team",
"emails.magicSession.subject": "Login",
"emails.magicSession.hello": "Hey,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Folge diesem Link, um dein {{project}}-Kennwort zurückzusetzen.",
"emails.recovery.footer": "Solltest du keine Kennwort-Zurücksetzung angefordert haben, kannst du diese Nachricht ignorieren.",
"emails.recovery.thanks": "Danke,",
+ "emails.recovery.buttonText": "Passwort zurücksetzen",
"emails.recovery.signature": "{{project}}-Team",
"emails.invitation.subject": "Einladung zum %s-Team auf %s",
"emails.invitation.hello": "Hello,",
"emails.invitation.body": "Du erhälst diese E-Mail, weil {{owner}} dich in das Team {{team}} auf {{project}} eingeladen hat.",
"emails.invitation.footer": "Wenn du nicht interessiert bist, kannst du diese Nachricht ignorieren.",
"emails.invitation.thanks": "Danke,",
+ "emails.invitation.buttonText": "Einladung zu {{team}} annehmen",
"emails.invitation.signature": "{{project}}-Team",
"locale.country.unknown": "Unbekannt",
"countries.af": "Afghanistan",
diff --git a/app/config/locale/translations/el.json b/app/config/locale/translations/el.json
index 1ef9cd30df..3576ffb865 100644
--- a/app/config/locale/translations/el.json
+++ b/app/config/locale/translations/el.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Ακολουθήστε αυτό το link για να επαληθεύσετε τη δ/νση του email σας",
"emails.verification.footer": "Εάν δεν ζητήσατε επαλήθευση αυτής της δ/νσης email, μπορείτε να αγνοήσετε αυτό το μήνυμα",
"emails.verification.thanks": "Ευχαριστούμε,",
+ "emails.verification.buttonText": "Επιβεβαιώστε διεύθυνση email",
"emails.verification.signature": "Η ομάδα του {{project}}",
"emails.magicSession.subject": "Είσοδος",
"emails.magicSession.hello": "Γεια σου,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Ακολουθήστε αυτό το link για να αλλάξετε τον {{project}} κωδικό σας",
"emails.recovery.footer": "Εάν δεν ζητήσατε αλλαγή του κωδικού σας πρόσβασης, μπορείτε να αγνοήσετε αυτό το μήνυμα",
"emails.recovery.thanks": "Ευχαριστούμε,",
+ "emails.recovery.buttonText": "Επαναφορά κωδικού πρόσβασης",
"emails.recovery.signature": "Η ομάδα του {{project}}",
"emails.invitation.subject": "Πρόσκληση στην %s Ομάδα στον %s",
"emails.invitation.hello": "Γεια σου,",
"emails.invitation.body": "Αυτό το email στάλθηκε επειδή ο/η {{owner}} θέλει να σας προσκαλέσει να γίνετε μέλος της ομάδας {{team}} του {{project}}.",
"emails.invitation.footer": "Εάν δεν ενδιαφέρεστε, μπορείτε να αγνοήσετε αυτό το μήνυμα.",
"emails.invitation.thanks": "Ευχαριστούμε,",
+ "emails.invitation.buttonText": "Αποδεχόμενος την πρόσκληση στην {{team}}",
"emails.invitation.signature": "Η ομάδα του {{project}}",
"locale.country.unknown": "Άγνωστο",
"countries.af": "Αφγανιστάν",
diff --git a/app/config/locale/translations/en.json b/app/config/locale/translations/en.json
index d9dfddb017..dbfa2e1be8 100644
--- a/app/config/locale/translations/en.json
+++ b/app/config/locale/translations/en.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Follow this link to verify your email address to your {{b}}{{project}}{{/b}} account.",
"emails.verification.footer": "If you didn’t ask to verify this address, you can ignore this message.",
"emails.verification.thanks": "Thanks,",
+ "emails.verification.buttonText": "Confirm email address",
"emails.verification.signature": "{{project}} team",
"emails.magicSession.subject": "{{project}} Login",
"emails.magicSession.hello": "Hello {{user}},",
@@ -45,12 +46,14 @@
"emails.recovery.body": "Follow this link to reset your {{b}}{{project}}{{/b}} password.",
"emails.recovery.footer": "If you didn't ask to reset your password, you can ignore this message.",
"emails.recovery.thanks": "Thanks,",
+ "emails.recovery.buttonText": "Reset password",
"emails.recovery.signature": "{{project}} team",
"emails.invitation.subject": "Invitation to %s Team at %s",
"emails.invitation.hello": "Hello {{user}},",
"emails.invitation.body": "This mail was sent to you because {{b}}{{owner}}{{/b}} wanted to invite you to become a member of the {{b}}{{team}}{{/b}} team at {{b}}{{project}}{{/b}}.",
"emails.invitation.footer": "If you are not interested, you can ignore this message.",
"emails.invitation.thanks": "Thanks,",
+ "emails.invitation.buttonText": "Accept invite to {{team}}",
"emails.invitation.signature": "{{project}} team",
"emails.certificate.subject": "Certificate failure for %s",
"emails.certificate.hello": "Hello,",
diff --git a/app/config/locale/translations/eo.json b/app/config/locale/translations/eo.json
index ba80bc602d..8aba49098b 100644
--- a/app/config/locale/translations/eo.json
+++ b/app/config/locale/translations/eo.json
@@ -7,6 +7,7 @@
"emails.verification.body": "Alklaku ĉi tiun ligon por kontroli vian retpoŝtan adreson.",
"emails.verification.footer": "Se vi ne petis ĉi tiun konfirmon de ĉi tiu retpoŝto, vi povas ignori ĉi tiun mesaĝon.",
"emails.verification.thanks": "Dankegon.,",
+ "emails.verification.buttonText": "Konfirmi retadreson",
"emails.verification.signature": "Teamo {{project}}",
"emails.magicSession.subject": "Login",
"emails.magicSession.hello": "Saluton,",
@@ -19,12 +20,14 @@
"emails.recovery.body": "Alklaku ĉi tiun ligon por reagordi vian pasvorton. {{project}}",
"emails.recovery.footer": "Se vi ne petis reagordi vian pasvorton, vi povas ignori ĉi tiun mesaĝon.",
"emails.recovery.thanks": "Dankegon,",
+ "emails.recovery.buttonText": "Pasvorton restarigi",
"emails.recovery.signature": "Teamo {{project}}",
"emails.invitation.subject": "Invito al la Teamo %s em %s",
"emails.invitation.hello": "Dankegon,",
"emails.invitation.body": "Ĉi tiu retpoŝto estis sendita ĉar la {{owner}} volas inviti vin fariĝi membro de la Teamo {{team}} en {{project}}.",
"emails.invitation.footer": "Se vi ne interesiĝas, vi povas ignori ĉi tiun mesaĝon.",
"emails.invitation.thanks": "Dankegon,",
+ "emails.invitation.buttonText": "Akcepti inviton al {{team}}",
"emails.invitation.signature": "Teamo {{project}}",
"locale.country.unknown": "Unknown",
"countries.af": "Afghanistan",
diff --git a/app/config/locale/translations/es.json b/app/config/locale/translations/es.json
index ff98fd28c7..e986b15f3c 100644
--- a/app/config/locale/translations/es.json
+++ b/app/config/locale/translations/es.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Haz clic en este enlace para verificar tu correo:",
"emails.verification.footer": "Si no has solicitado verificar este correo, puedes ignorar este mensaje.",
"emails.verification.thanks": "Gracias.,",
+ "emails.verification.buttonText": "Confirmar dirección de correo",
"emails.verification.signature": "El equipo de {{project}}.",
"emails.magicSession.subject": "Inicio de sesión",
"emails.magicSession.hello": "Hola,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Haz clic en este enlace para restablecer la contraseña de {{project}}:",
"emails.recovery.footer": "Si no has solicitado restablecer la contraseña, puedes ignorar este mensaje.",
"emails.recovery.thanks": "Gracias.,",
+ "emails.recovery.buttonText": "Restablecer contraseña",
"emails.recovery.signature": "El equipo de {{project}}",
"emails.invitation.subject": "Invitación al equipo %s en %s",
"emails.invitation.hello": "Hola,",
"emails.invitation.body": "Este correo ha sido enviado a petición de {{owner}} quién quiere invitarte a formar parte del equipo {{team}} en {{project}}.",
"emails.invitation.footer": "Si no estás interesado, puedes ignorar este mensaje.",
"emails.invitation.thanks": "Gracias.,",
+ "emails.invitation.buttonText": "Aceptar invitación a {{team}}",
"emails.invitation.signature": "El equipo de {{project}}",
"locale.country.unknown": "Desconocido",
"countries.af": "Afganistán",
diff --git a/app/config/locale/translations/fa.json b/app/config/locale/translations/fa.json
index f826a75118..9434b9ff03 100644
--- a/app/config/locale/translations/fa.json
+++ b/app/config/locale/translations/fa.json
@@ -8,6 +8,7 @@
"emails.verification.body": "برای تأیید ایمیلتان پیوند زیر را دنبال کنید.",
"emails.verification.footer": "اگر شما درخواست تأیید حساب ندادهاید، میتوانید این پیام را نادیده بگیرید.",
"emails.verification.thanks": "سپاس فراوان،",
+ "emails.verification.buttonText": "آدرس ایمیل را تایید کنید",
"emails.verification.signature": "تیم {{user}}",
"emails.magicSession.subject": "ورود به حساب کاربری",
"emails.magicSession.hello": "سلام،",
@@ -20,12 +21,14 @@
"emails.recovery.body": "برای بازیابی گذرواژهتان پیوند زیر را دنبال کنید.",
"emails.recovery.footer": "اگر شما درخواست بازیابی گذرواژه ندادهاید، میتوانید این پیام را نادیده بگیرید.",
"emails.recovery.thanks": "سپاس فراوان،",
+ "emails.recovery.buttonText": "بازنشانی رمز عبور",
"emails.recovery.signature": "تیم {{user}}",
"emails.invitation.subject": "دعوت به تیم %s در %s",
"emails.invitation.hello": "سلام،",
"emails.invitation.body": "این ایمیل برای شما فرستاده شدهاست زیرا {{owner}} میخواهد شما را به تیم {{team}} در پروژهی {{project}} بیفزاید.",
"emails.invitation.footer": "اگر علاقه ندارید، میتوانید این پیام را نادیده بگیرید.",
"emails.invitation.thanks": "سپاس فراوان،",
+ "emails.invitation.buttonText": "دعوت را به {{team}} بپذیرید",
"emails.invitation.signature": "تیم {{user}}",
"locale.country.unknown": "ناشناخته",
"countries.af": "افغانستان",
diff --git a/app/config/locale/translations/fr.json b/app/config/locale/translations/fr.json
index 1b60cb1910..3af7193764 100644
--- a/app/config/locale/translations/fr.json
+++ b/app/config/locale/translations/fr.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Suivez ce lien pour vérifier votre adresse e-mail.",
"emails.verification.footer": "Si vous n'avez pas demandé à vérifier cette adresse, vous pouvez ignorer ce message.",
"emails.verification.thanks": "Merci,",
+ "emails.verification.buttonText": "Confirmez l'adresse e-mail",
"emails.verification.signature": "Équipe {{project}}",
"emails.magicSession.subject": "Connexion",
"emails.magicSession.hello": "Bonjour,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Suivez ce lien pour réinitialiser votre mot de passe pour {{project}}.",
"emails.recovery.footer": "Si vous n'avez pas demandé à réinitialiser votre mot de passe, vous pouvez ignorer ce message.",
"emails.recovery.thanks": "Merci,",
+ "emails.recovery.buttonText": "Réinitialisation du mot de passe",
"emails.recovery.signature": "L'équipe {{project}}",
"emails.invitation.subject": "Invitation à l'équipe %s de %s",
"emails.invitation.hello": "Bonjour,",
"emails.invitation.body": "Cet e-mail vous a été envoyé parce que {{owner}} souhaite vous inviter à devenir membre de l'équipe {{team}} pour {{project}}.",
"emails.invitation.footer": "Si vous n'êtes pas intéressé, vous pouvez ignorer ce message.",
"emails.invitation.thanks": "Merci,",
+ "emails.invitation.buttonText": "Accepter l'invitation à {{team}}",
"emails.invitation.signature": "L'équipe {{project}}",
"locale.country.unknown": "Inconnu",
"countries.af": "Afghanistan",
diff --git a/app/config/locale/translations/ga.json b/app/config/locale/translations/ga.json
index 3ed68ad8c3..c486e77126 100644
--- a/app/config/locale/translations/ga.json
+++ b/app/config/locale/translations/ga.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Lean an nasc seo chun do ríomhphost a fhíorú.",
"emails.verification.footer": "Mura ndearna tú iarratas an seoladh seo a fhíoru, déan neamhaird den teachtaireacht seo.",
"emails.verification.thanks": "Go raibh maith agat,",
+ "emails.verification.buttonText": "Deimhnigh seoladh ríomhphoist",
"emails.verification.signature": "{{project}} foireann",
"emails.magicSession.subject": "Logáil isteach",
"emails.magicSession.hello": "Haigh,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Lean an nasc seo chun do pasfhocal {{project}} a athshocrú.",
"emails.recovery.footer": "Mura ndearna tú iarratas do pasfhocal a athshocrú, déan neamhaird den teachtaireacht seo.",
"emails.recovery.thanks": "Go raibh maith agat,",
+ "emails.recovery.buttonText": "Athshocraigh focal faire",
"emails.recovery.signature": "{{project}} foireann",
"emails.invitation.subject": "Cuireadh do %s foireann ag %s",
"emails.invitation.hello": "Haigh,",
"emails.invitation.body": "Seoladh an ríomhphost seo chugat mar ba mhaith le {{owner}} cuireadh a thabhairt duit bheith mar bhall den fhoireann {{team}} ag obair ar {{project}}.",
"emails.invitation.footer": "Is cuma leat? Déan neamhaird den teachtaireacht seo.",
"emails.invitation.thanks": "Go raibh maith agat,",
+ "emails.invitation.buttonText": "Glac le cuireadh chuig {{team}}",
"emails.invitation.signature": "{{project}} foireann",
"locale.country.unknown": "Neamhaithnid",
"countries.af": "An Afganastáin",
diff --git a/app/config/locale/translations/gu.json b/app/config/locale/translations/gu.json
index 54378caa9e..8d5d2fb8d6 100644
--- a/app/config/locale/translations/gu.json
+++ b/app/config/locale/translations/gu.json
@@ -8,6 +8,7 @@
"emails.verification.body": "તમારું ઇમેઇલ સરનામું ચકાસવા માટે આ લિંકને અનુસરો.",
"emails.verification.footer": "જો તમે આ સરનામાંની ચકાસણી કરવાનું ન કહ્યું હોય, તો તમે આ સંદેશને અવગણી શકો છો.",
"emails.verification.thanks": "આભાર,",
+ "emails.verification.buttonText": "ઇમેઇલ સરનામું ખાતરી કરો",
"emails.verification.signature": "{{project}} ટીમ",
"emails.magicSession.subject": "પ્રવેશ કરો",
"emails.magicSession.hello": "નમસ્કાર,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "તમારો {{project}} પાસવર્ડ ફરીથી સેટ કરવા માટે આ લિંકને અનુસરો.",
"emails.recovery.footer": "જો તમે તમારો પાસવર્ડ ફરીથી સેટ કરવાનું ન કહ્યું હોય, તો તમે આ સંદેશને અવગણી શકો છો.",
"emails.recovery.thanks": "આભાર,",
+ "emails.recovery.buttonText": "પાસવર્ડ રીસેટ કરો",
"emails.recovery.signature": "{{project}} ટીમ",
"emails.invitation.subject": "%s ટીમને %s પર આમંત્રણ",
"emails.invitation.hello": "નમસ્કાર,",
"emails.invitation.body": "આ મેઇલ તમને મોકલવામાં આવ્યો હતો કારણ કે {{owner}} તમને {{project}} માં {{team}} ટીમના સભ્ય બનવા માટે આમંત્રિત કરવા માંગતા હતો.",
"emails.invitation.footer": "જો તમને રસ નથી, તો તમે આ સંદેશને અવગણી શકો છો.",
"emails.invitation.thanks": "આભાર,",
+ "emails.invitation.buttonText": "{{team}} નું આમંત્રણ સ્વીકારો",
"emails.invitation.signature": "{{project}} ટીમ",
"locale.country.unknown": "અજાણ",
"countries.af": "અફઘાનિસ્તાન",
diff --git a/app/config/locale/translations/he.json b/app/config/locale/translations/he.json
index b3d4dea2a8..8e5279e5e4 100644
--- a/app/config/locale/translations/he.json
+++ b/app/config/locale/translations/he.json
@@ -8,6 +8,7 @@
"emails.verification.body": "לחץ על קישור זה כדי לאמת את כתובת הדוא\"ל שלך.",
"emails.verification.footer": "אם לא ביקשת לאמת כתובת זו, תוכל להתעלם מהודעה זו.",
"emails.verification.thanks": "תודה,",
+ "emails.verification.buttonText": "אשר כתובת דוא\"ל",
"emails.verification.signature": "צוות {{project}}",
"emails.magicSession.subject": "כניסה למערכת",
"emails.magicSession.hello": "שלום,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "עקוב אחר קישור זה כדי לאפס את סיסמתך ב-{{project}}.",
"emails.recovery.footer": "אם לא ביקשת לאפס את הסיסמה, תוכל להתעלם מהודעה זו.",
"emails.recovery.thanks": "תודה,",
+ "emails.recovery.buttonText": "סיסמא איפוס",
"emails.recovery.signature": "צוות {{project}}",
"emails.invitation.subject": "הזמנה לצוות %s ב- %s",
"emails.invitation.hello": "שלום,",
"emails.invitation.body": "דואר זה נשלח אליך מכיוון ש {{owner}} רצה להזמין אותך להיות חבר בצוות {{team}} ב-{{project}}.",
"emails.invitation.footer": "אם אינך מעוניין, תוכל להתעלם מהודעה זו.",
"emails.invitation.thanks": "תודה,",
+ "emails.invitation.buttonText": "אשר הזמנה ל-{{team}}",
"emails.invitation.signature": "צוות {{project}}",
"locale.country.unknown": "לא ידוע",
"countries.af": "אפגניסטן",
diff --git a/app/config/locale/translations/hi.json b/app/config/locale/translations/hi.json
index 1c4d531d60..ef71e287cd 100644
--- a/app/config/locale/translations/hi.json
+++ b/app/config/locale/translations/hi.json
@@ -8,6 +8,7 @@
"emails.verification.body": "इस लिंक के माध्यम से अपने ईमेल को सत्यापित कीजिये।",
"emails.verification.footer": "यदि आप इस पते को सत्यापित नहीं करना चाहते हैं, तो आप इस संदेश को नज़रअंदाज़ कर सकते हैं।",
"emails.verification.thanks": "धन्यवाद,",
+ "emails.verification.buttonText": "ईमेल पता सत्यापित करें",
"emails.verification.signature": "{{project}} टीम",
"emails.magicSession.subject": "लॉग इन",
"emails.magicSession.hello": "नमस्ते,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "इस लिंक के माध्यम से अपना {{project}} पासवर्ड रीसेट करें।",
"emails.recovery.footer": "यदि आप अपना पासवर्ड रीसेट नहीं करना चाहते हैं, तो आप इस संदेश को नज़रअंदाज़ कर सकते हैं।",
"emails.recovery.thanks": "धन्यवाद,",
+ "emails.recovery.buttonText": "पासवर्ड रीसेट करें",
"emails.recovery.signature": "{{project}} टीम",
"emails.invitation.subject": "%s टीम का यहाँ %s पर आमंत्रण",
"emails.invitation.hello": "नमस्ते,",
"emails.invitation.body": "यह मेल आपको इसलिए भेजा गया है क्योंकि {{owner}} आपको {{team}} टीम का सदस्य बनाना चाहते है, जो {{project}} से जुड़ा हुआ है।",
"emails.invitation.footer": "यदि आप इसमें रूचि नहीं रखते, तो आप इस संदेश को नज़रअंदाज़ कर सकते हैं।",
"emails.invitation.thanks": "धन्यवाद,",
+ "emails.invitation.buttonText": "{{team}} का निमंत्रण स्वीकार करें",
"emails.invitation.signature": "{{project}} टीम",
"locale.country.unknown": "अज्ञात",
"countries.af": "अफ़ग़ानिस्तान",
diff --git a/app/config/locale/translations/hr.json b/app/config/locale/translations/hr.json
index e5bf4719a9..8331d67422 100644
--- a/app/config/locale/translations/hr.json
+++ b/app/config/locale/translations/hr.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Slijedite ovu poveznicu da biste potvrdili svoju adresu e-pošte.",
"emails.verification.footer": "Ukoliko niste zatražili potvrdu ove adrese, možete zanemariti ovu poruku.",
"emails.verification.thanks": "Hvala,",
+ "emails.verification.buttonText": "Potvrdi adresu e-pošte",
"emails.verification.signature": "{{project}} tim",
"emails.magicSession.subject": "Prijavite se",
"emails.magicSession.hello": "Pozdrav,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Slijedite ovu poveznicu za ponovno postavljanje {{project}} lozinke.",
"emails.recovery.footer": "Ako niste zatražili ponovno postavljanje Vaše lozinke, možete zanemariti ovu poruku.",
"emails.recovery.thanks": "Hvala,",
+ "emails.recovery.buttonText": "Resetiraj lozinku",
"emails.recovery.signature": "{{project}} tim",
"emails.invitation.subject": "Pozivnica za %s tim na %s",
"emails.invitation.hello": "Pozdrav,",
"emails.invitation.body": "Ova poruka Vam je poslana jer Vas je {{owner}} htio pozvati da postanete član {{team}} tima na {{project}}.",
"emails.invitation.footer": "Ukoliko niste zainteresirani, možete zanemariti ovu poruku.",
"emails.invitation.thanks": "Hvala,",
+ "emails.invitation.buttonText": "Prihvati pozivnicu za {{team}}",
"emails.invitation.signature": "{{project}} tim",
"locale.country.unknown": "Nepoznato",
"countries.af": "Afganistan",
diff --git a/app/config/locale/translations/hu.json b/app/config/locale/translations/hu.json
index 589cb61859..c21701a509 100644
--- a/app/config/locale/translations/hu.json
+++ b/app/config/locale/translations/hu.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Kattints a linkre, hogy megerősítsd az email címedet.",
"emails.verification.footer": "Ha nem te kérted a címed megerősítését, akkor nyugodtan hagyd figyelmen kívül ezt az üzenetet.",
"emails.verification.thanks": "Köszönettel,",
+ "emails.verification.buttonText": "E-mail-cím megerősítése",
"emails.verification.signature": "a {{project}} csapat",
"emails.magicSession.subject": "Bejelentkezés",
"emails.magicSession.hello": "Szia,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Kattints a linkre a {{project}} jelszavad visszaállításához.",
"emails.recovery.footer": "Ha nem te kezdeményezted a jelszavad visszaállítását, akkor nyugodtan hagyd figyelmen kívül ezt az üzenetet.",
"emails.recovery.thanks": "Köszönettel,",
+ "emails.recovery.buttonText": "Jelszó visszaállítása",
"emails.recovery.signature": "a {{project}} csapat",
"emails.invitation.subject": "Meghívó a(z) %s csapatba, a(z) %s projektbe",
"emails.invitation.hello": "Szia,",
"emails.invitation.body": "Ezt a levelet azért kaptad, mert {{owner}} meghívott, hogy légy a {{team}} csapat tagja a {{project}} projektben.",
"emails.invitation.footer": "Ha nem érdekel a lehetőség, nyugodtan hagyd figyelmen kívül ezt az üzenetet.",
"emails.invitation.thanks": "Köszönettel,",
+ "emails.invitation.buttonText": "Elfogadni meghívást a {{team}-re",
"emails.invitation.signature": "a {{project}} csapat",
"locale.country.unknown": "Ismeretlen",
"countries.af": "Afganisztán",
diff --git a/app/config/locale/translations/id.json b/app/config/locale/translations/id.json
index c28b15f15d..836941f79a 100644
--- a/app/config/locale/translations/id.json
+++ b/app/config/locale/translations/id.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Ikuti tautan ini untuk memverifikasi alamat email Anda.",
"emails.verification.footer": "Jika Anda tidak meminta untuk memverifikasi alamat email ini, Anda dapat mengabaikan pesan ini.",
"emails.verification.thanks": "Terima kasih,",
+ "emails.verification.buttonText": "Konfirmasi alamat email",
"emails.verification.signature": "Tim {{project}}",
"emails.magicSession.subject": "Masuk",
"emails.magicSession.hello": "Hai,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Ikuti tautan ini untuk menyetel ulang kata sandi {{project}} Anda.",
"emails.recovery.footer": "Jika Anda tidak meminta untuk menyetel ulang kata sandi, Anda dapat mengabaikan pesan ini.",
"emails.recovery.thanks": "Terima kasih,",
+ "emails.recovery.buttonText": "Atur ulang kata sandi",
"emails.recovery.signature": "Tim {{project}}",
"emails.invitation.subject": "Undangan ke Tim %s di %s",
"emails.invitation.hello": "Halo,",
"emails.invitation.body": "Email ini dikirimkan kepada Anda karena {{owner}} ingin mengundang Anda untuk menjadi anggota tim {{team}} di {{project}}.",
"emails.invitation.footer": "Jika Anda tidak tertarik, Anda dapat mengabaikan pesan ini.",
"emails.invitation.thanks": "Terima kasih,",
+ "emails.invitation.buttonText": "Terima undangan ke {{team}}",
"emails.invitation.signature": "Tim {{project}}",
"locale.country.unknown": "Tidak diketahui",
"countries.af": "Afganistan",
diff --git a/app/config/locale/translations/it.json b/app/config/locale/translations/it.json
index 8d45de9903..f0e290b481 100644
--- a/app/config/locale/translations/it.json
+++ b/app/config/locale/translations/it.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Clicca questo link per verificare il tuo indirizzo email.",
"emails.verification.footer": "Se non hai richiesto la verifica dell’indirizzo email, puoi ignorare questo messaggio.",
"emails.verification.thanks": "Grazie,",
+ "emails.verification.buttonText": "Confermare l'indirizzo email",
"emails.verification.signature": "Il team {{project}}",
"emails.magicSession.subject": "Login",
"emails.magicSession.hello": "Ciao,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Clicca questo link per reimpostare la tua password di {{project}}.",
"emails.recovery.footer": "Se non hai richiesto la reimpostazione della password, puoi ignorare questo messaggio.",
"emails.recovery.thanks": "Grazie,",
+ "emails.recovery.buttonText": "Reimposta password",
"emails.recovery.signature": "Il team {{project}}",
"emails.invitation.subject": "Invito al Team %s per %s",
"emails.invitation.hello": "Ciao,",
"emails.invitation.body": "Hai ricevuto questa email perché {{owner}} ti ha invitato a diventare un membro del team {{team}} di {{project}}.",
"emails.invitation.footer": "Ignora questo messaggio se non sei interessatə.",
"emails.invitation.thanks": "Grazie,",
+ "emails.invitation.buttonText": "Accetta invito a {{team}}",
"emails.invitation.signature": "Il team {{project}}",
"locale.country.unknown": "Sconosciuto",
"countries.af": "Afghanistan",
diff --git a/app/config/locale/translations/ja.json b/app/config/locale/translations/ja.json
index 76d9a0cb1f..f3ad8fe1ed 100644
--- a/app/config/locale/translations/ja.json
+++ b/app/config/locale/translations/ja.json
@@ -8,6 +8,7 @@
"emails.verification.body": "メールアドレスを有効化するためには下記リンクをクリックして下さい。",
"emails.verification.footer": "このメールに心当たりが無い場合は破棄をお願いいたします。",
"emails.verification.thanks": "ご利用いただきありがとうございます。、",
+ "emails.verification.buttonText": "メールアドレスを確認する",
"emails.verification.signature": "{{project}}チーム",
"emails.magicSession.subject": "ログイン",
"emails.magicSession.hello": "こんにちは、",
@@ -20,12 +21,14 @@
"emails.recovery.body": "パスワードをリセットするためには下記リンクをクリックしてください。",
"emails.recovery.footer": "このメールに心当たりが無い場合は破棄をお願いいたします。",
"emails.recovery.thanks": "ご利用いただきありがとうございます。、",
+ "emails.recovery.buttonText": "パスワードをリセット",
"emails.recovery.signature": "{{project}}チーム",
"emails.invitation.subject": "%sチームへの招待が%sから来ました。",
"emails.invitation.hello": "こんにちは、",
"emails.invitation.body": "{{owner}}さんが{{project}}の{{team}}チームにあなたを招待しています。",
"emails.invitation.footer": "このメールに心当たりが無い場合は破棄をお願いいたします。",
"emails.invitation.thanks": "ご利用いただきありがとうございます。、",
+ "emails.invitation.buttonText": "{{team}}への招待を承諾する",
"emails.invitation.signature": "{{project}}チーム",
"locale.country.unknown": "不明",
"countries.af": "アフガニスタン",
diff --git a/app/config/locale/translations/jv.json b/app/config/locale/translations/jv.json
index 889e968b4d..71d4f4b24a 100644
--- a/app/config/locale/translations/jv.json
+++ b/app/config/locale/translations/jv.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Klik link iki kanggo verifikasi alamat email sampeyan.",
"emails.verification.footer": "Yen sampeyan ora njaluk verifikasi alamat iki, sampeyan iso nglirwakake pesen iki.",
"emails.verification.thanks": "Matur nuwun,",
+ "emails.verification.buttonText": "Konfirmasi alamat email",
"emails.verification.signature": "Tim {{project}}",
"emails.magicSession.subject": "Masuk",
"emails.magicSession.hello": "Hai,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Klik link iki kanggo setel ulang sandi {{project}}.",
"emails.recovery.footer": "Yen sampeyan ora njaluk setel ulang sandi, sampeyan iso nglirwakake pesen iki.",
"emails.recovery.thanks": "Matur nuwun,",
+ "emails.recovery.buttonText": "Reset sandhi",
"emails.recovery.signature": "Tim {{project}}",
"emails.invitation.subject": "Undangan ke Tim %s di %s",
"emails.invitation.hello": "Halo,",
"emails.invitation.body": "Email iki dikirim menyang sampeyan amarga {{owner}} pengin ngajak sampeyan dadi anggota tim {{team}} di {{project}}.",
"emails.invitation.footer": "Yen sampeyan ora tertarik, sampeyan iso nglirwakake pesen iki.",
"emails.invitation.thanks": "Matur nuwun,",
+ "emails.invitation.buttonText": "Tampa undhangan menyang {{team}}",
"emails.invitation.signature": "Tim {{project}}",
"locale.country.unknown": "Ora dingerteni",
"countries.af": "Afghanistan",
diff --git a/app/config/locale/translations/kn.json b/app/config/locale/translations/kn.json
index ba57c21155..ed35a7947f 100644
--- a/app/config/locale/translations/kn.json
+++ b/app/config/locale/translations/kn.json
@@ -8,6 +8,7 @@
"emails.verification.body": "ನಿಮ್ಮ ಇಮೇಲ್ ವಿಳಾಸ ಪರಿಶೀಲನೆಗೆ ಈ ಲಿಂಕನ್ನು ಅನುಸರಿಸಿ",
"emails.verification.footer": "ನೀವು ಇಮೇಲ್ ವಿಳಾಸ ಪರಿಶೀಲನೆಗೆ ಕೇಳದಿದ್ದರೆ, ಈ ಸಂದೇಶವನ್ನು ನಿರ್ಲಕ್ಷಿಸಿ",
"emails.verification.thanks": "ಧನ್ಯವಾದಗಳು,",
+ "emails.verification.buttonText": "ಇಮೇಲ್ ವಿಳಾಸವನ್ನು ದೃಢೀಕರಿಸಿ",
"emails.verification.signature": "{{project}} ತಂಡ",
"emails.magicSession.subject": "ಲಾಗಿನ್",
"emails.magicSession.hello": "ನಮಸ್ಕಾರ,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "ನಿಮ್ಮ {{project}} ಗುಪ್ತಪದವನ್ನು ಮರುಹೊಂದಿಸಲು ಈ ಲಿಂಕನ್ನು ಅನುಸರಿಸಿ",
"emails.recovery.footer": "ನೀವು ಗುಪ್ತಪದವನ್ನು ಮರುಹೊಂದಿಸಲು ಕೇಳದಿದ್ದರೆ, ಈ ಸಂದೇಶವನ್ನು ನಿರ್ಲಕ್ಷಿಸಿ",
"emails.recovery.thanks": "ಧನ್ಯವಾದಗಳು,",
+ "emails.recovery.buttonText": "ಗುಪ್ತಪದವನ್ನು ಮರುಸೆಟ್ ಮಾಡಿ",
"emails.recovery.signature": "{{project}} ತಂಡ",
"emails.invitation.subject": "%s ತಂಡಕ್ಕೆ %s ರಲ್ಲಿ ಆಹ್ವಾನ",
"emails.invitation.hello": "ನಮಸ್ಕಾರ,",
"emails.invitation.body": "ಈ ಇಮೇಲ್ ನಿಮಗೆ ಬಂದಿದೆ ಏಕೆಂದರೆ {{owner}} ನಿಮ್ಮನ್ನು {{team}} ತಂಡದ {{project}}ರಲ್ಲಿ ಸದಸ್ಯ ಆಗಲಿಕ್ಕೆ ಆಹ್ವಾನಿಸಿದ್ದಾರೆ",
"emails.invitation.footer": "ನಿಮಗೆ ಆಸಕ್ತಿಯಿಲ್ಲದಿದ್ದರೆ, ಈ ಸಂದೇಶವನ್ನು ನಿರ್ಲಕ್ಷಿಸಿ",
"emails.invitation.thanks": "ಧನ್ಯವಾದಗಳು,",
+ "emails.invitation.buttonText": "{{team}} ಗೆ ಆಹ್ವಾನವನ್ನು ಸ್ವೀಕರಿಸಿ",
"emails.invitation.signature": "{{project}} ತಂಡ",
"locale.country.unknown": "Unknown",
"countries.af": "ಅಫ್ಘಾನಿಸ್ತಾನ",
diff --git a/app/config/locale/translations/ko.json b/app/config/locale/translations/ko.json
index c33c961130..0bc425aeae 100644
--- a/app/config/locale/translations/ko.json
+++ b/app/config/locale/translations/ko.json
@@ -8,6 +8,7 @@
"emails.verification.body": "이메일 인증을 위해 링크를 클릭하여주세요.",
"emails.verification.footer": "이메일 인증을 부탁하지 않으셨다면 이 메시지를 무시하여주세요.",
"emails.verification.thanks": "감사합니다、",
+ "emails.verification.buttonText": "이메일 주소를 확인합니다",
"emails.verification.signature": "{{project}} 팀",
"emails.magicSession.subject": "로그인",
"emails.magicSession.hello": "안녕하세요、",
@@ -20,12 +21,14 @@
"emails.recovery.body": "{{project}}의 비밀번호 재설정을 위해 링크를 클릭하여주세요.",
"emails.recovery.footer": "비밀번호 재설정 신청을 하지 않으셨다면 이 메세지를 무시하여주세요.",
"emails.recovery.thanks": "감사합니다、",
+ "emails.recovery.buttonText": "비밀번호 재설정",
"emails.recovery.signature": "{{project}} 팀",
"emails.invitation.subject": "초대장 %s 팀 - %s",
"emails.invitation.hello": "안녕하세요、",
"emails.invitation.body": "{{owner}}님이 귀하를 {{project}}의 {{team}} 팀으로 초대합니다.",
"emails.invitation.footer": "팀에 합류할 의사가 없으시면 이 메세지를 무시하여주세요.",
"emails.invitation.thanks": "감사합니다、",
+ "emails.invitation.buttonText": "{{team}} 초대를 수락하기",
"emails.invitation.signature": "{{project}} 팀",
"locale.country.unknown": "알려지지 않은",
"countries.af": "아프가니스탄",
diff --git a/app/config/locale/translations/la.json b/app/config/locale/translations/la.json
index bebef26854..fe3e7930e2 100644
--- a/app/config/locale/translations/la.json
+++ b/app/config/locale/translations/la.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Sequere hanc nexum ut quin inscriptionem tuum.",
"emails.verification.footer": "Si verificationem huius inscriptionis non postulasti, nuntium hunc ignorare potes.",
"emails.verification.thanks": "Gratias,",
+ "emails.verification.buttonText": "Confirma inscriptionem electronicam",
"emails.verification.signature": "{{project}} Team",
"emails.magicSession.subject": "Log in",
"emails.magicSession.hello": "Salve ibi,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Sequere hanc conjunctionem ut recipias project password {{project}}",
"emails.recovery.footer": "Si tesseram tuam recuperare non petis, nuntium hunc ignorare potes",
"emails.recovery.thanks": "Gratias,",
+ "emails.recovery.buttonText": "Reset password",
"emails.recovery.signature": "{{project}} team",
"emails.invitation.subject": "Invitatio pro %s in quadrigis %s",
"emails.invitation.hello": "Salve ibi,",
"emails.invitation.body": "Haec inscriptio ad te missa est quia dominus incepto {{owner}} te invitare vult ut membrum {{team}} quadrigis fias ad {{project}}",
"emails.invitation.footer": "Si non quaero, potes hunc nuntium ignorare",
"emails.invitation.thanks": "Gratias,",
+ "emails.invitation.buttonText": "Accipe invitare ad {{team}}",
"emails.invitation.signature": "{{project}} team",
"locale.country.unknown": "Ignotum",
"countries.af": "Afghanistan",
diff --git a/app/config/locale/translations/lb.json b/app/config/locale/translations/lb.json
index 91b52e4a18..8fe4b346e7 100644
--- a/app/config/locale/translations/lb.json
+++ b/app/config/locale/translations/lb.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Follegt dëse Link fir Är E -Mail Adress z'iwwerpréiwen.",
"emails.verification.footer": "Wann Dir net gefrot hutt dës Adress z'iwwerpréiwen, kënnt Dir dëse Message ignoréieren.",
"emails.verification.thanks": "Merci,",
+ "emails.verification.buttonText": "E-Mail-Adress bestätegen",
"emails.verification.signature": "{{project}} équipe",
"emails.magicSession.subject": "Login",
"emails.magicSession.hello": "Hey,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Follegt dëse Link fir Äert {{project}} Passwuert zréckzesetzen.",
"emails.recovery.footer": "Wann Dir net gefrot hutt Äert Passwuert zréckzesetzen, kënnt Dir dëse Message ignoréieren.",
"emails.recovery.thanks": "Merci,",
+ "emails.recovery.buttonText": "Passwuert zrécksetzen",
"emails.recovery.signature": "{{project}} équipe",
"emails.invitation.subject": "Invitatioun un %s équipe bei %s",
"emails.invitation.hello": "Hallo,",
"emails.invitation.body": "Dës E -Mail gouf un Iech geschéckt well {{owner}} Iech invitéiere wëllt fir Member vum {{team}} Team bei {{project}} ze ginn.",
"emails.invitation.footer": "Wann Dir net interesséiert sidd, kënnt Dir dëse Message ignoréieren.",
"emails.invitation.thanks": "Merci,",
+ "emails.invitation.buttonText": "Invitatioun bei {{team}} akzeptéieren",
"emails.invitation.signature": "{{project}} équipe",
"locale.country.unknown": "Onbekannt",
"countries.af": "Afghanistan",
diff --git a/app/config/locale/translations/lt.json b/app/config/locale/translations/lt.json
index 94c874ce82..2439428b02 100644
--- a/app/config/locale/translations/lt.json
+++ b/app/config/locale/translations/lt.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Spauskite šią nuorodą, kad patvirtintumėte savo el. paštą.",
"emails.verification.footer": "Jei neprašėte patvirtinti šio el. pašto, galite ignoruoti šį pranešimą.",
"emails.verification.thanks": "Ačiū,",
+ "emails.verification.buttonText": "Patvirtinti el. pašto adresą",
"emails.verification.signature": "{{project}} komanda",
"emails.magicSession.subject": "Prisijungti",
"emails.magicSession.hello": "Labas,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Spauskite šią nuorodą, kad atkurtumėte projekto {{project}} slaptažodį.",
"emails.recovery.footer": "Jei neprašėte atkurti savo slaptažodzio, galite ignoruoti šį pranešimą.",
"emails.recovery.thanks": "Ačiū,",
+ "emails.recovery.buttonText": "Atstatyti slaptažodį",
"emails.recovery.signature": "{{project}} komanda",
"emails.invitation.subject": "Pakvietimas į %s komandą %s projekte",
"emails.invitation.hello": "Labas,",
"emails.invitation.body": "Šis el. laiškas buvo atsiųstas jums, nes {{owner}} norėjo jus pakviesti tapti projekto {{project}} dalimi {{team}} komandoje.",
"emails.invitation.footer": "Jei jūsų tai nedomina, galite ignoruoti šį pranešimą.",
"emails.invitation.thanks": "Ačiū,",
+ "emails.invitation.buttonText": "Priimti kvietimą į {{team}}",
"emails.invitation.signature": "{{project}} komanda",
"locale.country.unknown": "Nežinoma",
"countries.af": "Afganistanas",
diff --git a/app/config/locale/translations/lv.json b/app/config/locale/translations/lv.json
index b4a396367c..59edfce7a6 100644
--- a/app/config/locale/translations/lv.json
+++ b/app/config/locale/translations/lv.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Sekojiet saitei, lai apstiprinātu savu e-pasta adresi.",
"emails.verification.footer": "Ja Jūs nepieprasījāt šīs adreses apstiprinājumu, lūdzu, ignorējiet šo ziņu.",
"emails.verification.thanks": "Paldies,",
+ "emails.verification.buttonText": "Apstiprināt e-pasta adresi",
"emails.verification.signature": "{{project}} komanda",
"emails.magicSession.subject": "Ieiet",
"emails.magicSession.hello": "Sveicināti,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Sekojiet saitei, lai atjauninātu {{project}} paroli.",
"emails.recovery.footer": "Ja Jūs nepieprasījāt paroles atjaunināšanu, lūdzu, ignorējiet šo ziņu.",
"emails.recovery.thanks": "Paldies,",
+ "emails.recovery.buttonText": "Atiestatīt paroli",
"emails.recovery.signature": "{{project}} komanda",
"emails.invitation.subject": "Ielūgums piebiedroties %s komandai %s projektā.",
"emails.invitation.hello": "Labdien,",
"emails.invitation.body": "Šis e-pasts tika nosūtīts Jums, jo {{owner}} vēlējās Jūs ielūgt kļūt par {{team}} komandas biedru {{project}} projektā.",
"emails.invitation.footer": "Ja Jūs neesat ieinteresēts, lūdzu, ignorējiet šo ziņu.",
"emails.invitation.thanks": "Paldies,",
+ "emails.invitation.buttonText": "Pieņemt ielūgumu uz {{team}}",
"emails.invitation.signature": "{{project}} komanda",
"locale.country.unknown": "Nav zināms",
"countries.af": "Afganistāna",
diff --git a/app/config/locale/translations/ml.json b/app/config/locale/translations/ml.json
index 1b57d87865..bd13f92fa8 100644
--- a/app/config/locale/translations/ml.json
+++ b/app/config/locale/translations/ml.json
@@ -8,6 +8,7 @@
"emails.verification.body": "നിങ്ങളുടെ ഇമെയിൽ വിലാസം സ്ഥിരീകരിക്കുന്നതിനായി ഈ ലിങ്ക് പിന്തുടരുക.",
"emails.verification.footer": "ഈ വിലാസം സ്ഥിരീകരിക്കാന് നിങ്ങൾ ആവശ്യപ്പെട്ടില്ലെങ്കിൽ, നിങ്ങൾക്ക് ഈ സന്ദേശം അവഗണിക്കാവുന്നതാണ്.",
"emails.verification.thanks": "നന്ദി,",
+ "emails.verification.buttonText": "ഇമെയിൽ വിലാസം സ്ഥിരീകരിക്കുക",
"emails.verification.signature": "{{project}} ടീം",
"emails.magicSession.subject": "ലോഗിൻ",
"emails.magicSession.hello": "നമസ്കാരം,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "നിങ്ങളുടെ {{Project}} രഹസ്യവാക്ക് പുനക്രമീകരിക്കുന്നതിന് ഈ ലിങ്ക് പിന്തുടരുക.",
"emails.recovery.footer": "നിങ്ങളുടെ രഹസ്യവാക്ക് പുനക്രമീകരിക്കാന് നിങ്ങൾ ആവശ്യപ്പെട്ടില്ലെങ്കിൽ, ഈ സന്ദേശം അവഗണിക്കാവുന്നതാണ്.",
"emails.recovery.thanks": "നന്ദി,",
+ "emails.recovery.buttonText": "പാസ്വേഡ് റീസെറ്റ് ചെയ്യുക",
"emails.recovery.signature": "{{project}} ടീം",
"emails.invitation.subject": "%s -ലെ %s ടീമിലേക്കുള്ള ക്ഷണം",
"emails.invitation.hello": "നമസ്കാരം,",
"emails.invitation.body": "നിങ്ങളെ {{project}} -ലെ {{team}} ടീമിലെ അംഗമാകുവാന് ക്ഷണിക്കാൻ {{owner}} ആഗ്രഹിക്കുന്നതിനാലാണ് ഈ മെയിൽ നിങ്ങൾക്ക് അയക്കുന്നത്.",
"emails.invitation.footer": "നിങ്ങൾക്ക് താൽപ്പര്യമില്ലെങ്കിൽ, ഈ സന്ദേശം അവഗണിക്കാവുന്നതാണ്.",
"emails.invitation.thanks": "നന്ദി,",
+ "emails.invitation.buttonText": "{{team}} ലേക്കുള്ള ക്ഷണം സ്വീകരിക്കുക",
"emails.invitation.signature": "{{project}} ടീം",
"locale.country.unknown": "Unknown",
"countries.af": "അഫ്ഗാനിസ്ഥാൻ",
diff --git a/app/config/locale/translations/mr.json b/app/config/locale/translations/mr.json
index 6550d1c1ba..881afdfe71 100644
--- a/app/config/locale/translations/mr.json
+++ b/app/config/locale/translations/mr.json
@@ -8,6 +8,7 @@
"emails.verification.body": "आपला ईमेल पत्ता सत्यापित करण्यासाठी या दुव्याचे अनुसरण करा.",
"emails.verification.footer": "आपण या पत्त्याची पडताळणी करण्यास सांगितले नसल्यास, आपण या संदेशाकडे दुर्लक्ष करू शकता.",
"emails.verification.thanks": "धन्यवाद,",
+ "emails.verification.buttonText": "ईमेल पत्ता सत्यापित करा",
"emails.verification.signature": "{{project}} संघ",
"emails.magicSession.subject": "लॉगिन करा",
"emails.magicSession.hello": "नमस्कार ,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "आपला {{project}}चे पासवर्ड रीसेट करण्यासाठी या लिंकचे अनुसरण करा",
"emails.recovery.footer": "आपण आपला पासवर्ड रीसेट करण्यास सांगितले नसल्यास, आपण या संदेशाकडे दुर्लक्ष करू शकता.",
"emails.recovery.thanks": "धन्यवाद,",
+ "emails.recovery.buttonText": "पासवर्ड रीसेट करा",
"emails.recovery.signature": "{{project}} संघ",
"emails.invitation.subject": "%s संघ %s येथे सामील होण्यासाठी आमंत्रण",
"emails.invitation.hello": "नमस्कार,",
"emails.invitation.body": "हा मेल तुम्हाला पाठवला होता कारण {{owner}} तुम्हाला {{project}} येथे {{team}} टीमचे सदस्य होण्यासाठी आमंत्रित करू इच्छित होते.",
"emails.invitation.footer": "आपल्याला स्वारस्य नसल्यास, आपण या संदेशाकडे दुर्लक्ष करू शकता.",
"emails.invitation.thanks": "धन्यवाद,",
+ "emails.invitation.buttonText": "{{team}} साठी आमंत्रण स्वीकारा",
"emails.invitation.signature": "{{project}} संघ",
"locale.country.unknown": "अज्ञात",
"countries.af": "अफगानिस्तान",
diff --git a/app/config/locale/translations/ms.json b/app/config/locale/translations/ms.json
index a02c36b075..448307550e 100644
--- a/app/config/locale/translations/ms.json
+++ b/app/config/locale/translations/ms.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Tekan pautan ini untuk mengesahkan alamat email anda.",
"emails.verification.footer": "Sekiranya anda tidak membuat permintaan untuk mengesahkan email ini, sila abaikan mesej ini.",
"emails.verification.thanks": "Terima kasih,",
+ "emails.verification.buttonText": "Sahkan alamat email",
"emails.verification.signature": "{{project}} team",
"emails.magicSession.subject": "Log masuk",
"emails.magicSession.hello": "Hey,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Tekan pautan ini untuk menetapkan semula kata laluan {{project}}.",
"emails.recovery.footer": "Sekiranya anda tidak membuat permintaan menetap semula kata laluan, sila abaikan mesej ini.",
"emails.recovery.thanks": "Terima kasih,",
+ "emails.recovery.buttonText": "Tetapkan semula kata laluan",
"emails.recovery.signature": "{{project}} team",
"emails.invitation.subject": "Jemputan ke pasukan %s di %s",
"emails.invitation.hello": "Hello,",
"emails.invitation.body": "Anda menerima mel ini kerana {{owner}} ingin menjemput anda untuk menjadi ahli pasukan {{team}} di {{project}}.",
"emails.invitation.footer": "Sekiranya anda tidak berminat, sila abaikan mesej ini.",
"emails.invitation.thanks": "Terima kasih,",
+ "emails.invitation.buttonText": "Terima jemputan ke {{team}}",
"emails.invitation.signature": "{{project}} team",
"locale.country.unknown": "Tidak Diketahui",
"countries.af": "Afghanistan",
diff --git a/app/config/locale/translations/nb.json b/app/config/locale/translations/nb.json
index daf18abc1c..cc95bacf9e 100644
--- a/app/config/locale/translations/nb.json
+++ b/app/config/locale/translations/nb.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Følg denne lenken for å bekrefte din e-postadresse.",
"emails.verification.footer": "Dersom du ikke ba om å bekrefte e-postadressen, kan du se bort fra denne meldingen.",
"emails.verification.thanks": "Takk,",
+ "emails.verification.buttonText": "Bekreft e-postadresse",
"emails.verification.signature": "{{project}} team",
"emails.magicSession.subject": "Pålogging",
"emails.magicSession.hello": "Hei,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Følg denne lenken for å nullstille ditt {{project}} passord.",
"emails.recovery.footer": "Dersom du ikke ba om å nullstille passordet ditt, kan du se bort fra denne meldingen.",
"emails.recovery.thanks": "Takk,",
+ "emails.recovery.buttonText": "Tilbakestill passord",
"emails.recovery.signature": "{{project}} team",
"emails.invitation.subject": "Invitasjon til %s Team ved %s",
"emails.invitation.hello": "Hei,",
"emails.invitation.body": "Denne meldingen ble sendt til deg fordi {{owner}} ønsket å invitere deg til å bli medlem av {{team}} team ved {{project}}.",
"emails.invitation.footer": "Dersom du ikke er interessert, kan du se bort fra denne meldingen.",
"emails.invitation.thanks": "Takk,",
+ "emails.invitation.buttonText": "Godta invitasjon til {{team}}",
"emails.invitation.signature": "{{project}} team",
"locale.country.unknown": "Ukjent",
"countries.af": "Afghanistan",
diff --git a/app/config/locale/translations/ne.json b/app/config/locale/translations/ne.json
index 4f05a9b5ba..f1ba841fed 100644
--- a/app/config/locale/translations/ne.json
+++ b/app/config/locale/translations/ne.json
@@ -8,6 +8,7 @@
"emails.verification.body": "इमेल ठेगाना प्रमाणित गर्नको लागी यो लिंकमा जानुहोस।",
"emails.verification.footer": "यदि तपाइँले आफ्नो खाता प्रमाणित गर्न सोध्नु भएको छैन भने तपाइँले यो सन्देश लाई बेवास्ता गर्न सक्नुहुन्छ।",
"emails.verification.thanks": "धन्यवाद,",
+ "emails.verification.buttonText": "इमेल ठेगाना पुष्टि गर्नुहोस्",
"emails.verification.signature": "{{project}} समूह",
"emails.magicSession.subject": "लगइन",
"emails.magicSession.hello": "नमस्ते,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "{{project}}को पासवर्ड रिसेट गर्नको लागी यो लिंकमा जानुहोस।",
"emails.recovery.footer": "यदि तपाइँले आफ्नो पासवर्ड रिसेट गर्न सोध्नु भएको छैन भने तपाइँले यो सन्देश लाई बेवास्ता गर्न सक्नुहुन्छ।",
"emails.recovery.thanks": "धन्यवाद,",
+ "emails.recovery.buttonText": "रिसेट पासवर्ड",
"emails.recovery.signature": "{{project}} समूह",
"emails.invitation.subject": "%s समूहको लागि %s मा निमन्त्रणा",
"emails.invitation.hello": "नमस्ते,",
"emails.invitation.body": "{{owner}}ले तपाइँलाई {{project}}मा {{team}}को सदस्य बन्न आमन्त्रित गर्न चाहनु भएको छ। त्येसैले तपाइँलाई यो सन्देश पठाइएको हो।",
"emails.invitation.footer": "यदि तपाइँ इच्छुक हुनुहुन्न भने, तपाइँले यो सन्देशलाई बेवास्ता गर्न सक्नुहुन्छ।",
"emails.invitation.thanks": "धन्यवाद,",
+ "emails.invitation.buttonText": "{{team}} मा निमन्त्रणा स्वीकार गर्नुहोस्",
"emails.invitation.signature": "{{project}} समूह",
"locale.country.unknown": "अज्ञात",
"countries.af": "अफगानिस्तान",
diff --git a/app/config/locale/translations/nl.json b/app/config/locale/translations/nl.json
index cae82a9a37..4f71f67199 100644
--- a/app/config/locale/translations/nl.json
+++ b/app/config/locale/translations/nl.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Volg deze link om uw e-mail te verifieren",
"emails.verification.footer": "Als u geen aanvraag voor verificatie heeft gemaakt, kan u deze mail negeren",
"emails.verification.thanks": "Bedankt,",
+ "emails.verification.buttonText": "Bevestig e-mailadres",
"emails.verification.signature": "{{project}} team",
"emails.magicSession.subject": "Login",
"emails.magicSession.hello": "Hoi,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Volg deze link om het wachtwoord van uw project {{project}} te wijzigen",
"emails.recovery.footer": "Als u geen aanvraag heeft gemaakt om uw wachtwoord te wijzigen, kan u deze mail negeren",
"emails.recovery.thanks": "Bedankt,",
+ "emails.recovery.buttonText": "Wachtwoord opnieuw instellen",
"emails.recovery.signature": "{{project}} team",
"emails.invitation.subject": "Uitnodiging van %s Team uit %s",
"emails.invitation.hello": "Hallo,",
"emails.invitation.body": "U ontvangt deze mail want u was uitgenodig door {{owner}} om lid van het {{team}} team te worden in {{project}} ",
"emails.invitation.footer": "Als u niet geintereseerd bent, kan u deze mail negeren.",
"emails.invitation.thanks": "Bedankt,",
+ "emails.invitation.buttonText": "Uitnodiging voor {{team}} accepteren",
"emails.invitation.signature": "{{project}} team",
"locale.country.unknown": "Onbekend",
"countries.af": "Afghanistan",
diff --git a/app/config/locale/translations/nn.json b/app/config/locale/translations/nn.json
index 44be0f9845..646a57904c 100644
--- a/app/config/locale/translations/nn.json
+++ b/app/config/locale/translations/nn.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Følg denne lenkja for å bekrefta din e-postadresse.",
"emails.verification.footer": "Om du ikkje bad om å bekrefta e-postadressa, kan du ignorera denne meldinga.",
"emails.verification.thanks": "Takk,",
+ "emails.verification.buttonText": "Stadfest e-postadresse",
"emails.verification.signature": "{{project}} team",
"emails.magicSession.subject": "Pålogging",
"emails.magicSession.hello": "Hei,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Følg denne lenkja for å nullstilla ditt {{project}} passord.",
"emails.recovery.footer": "Om du ikkje ba om å nullstilla passordet ditt, kan du ignorera denne meldinga.",
"emails.recovery.thanks": "Takk,",
+ "emails.recovery.buttonText": "Nullstill passord",
"emails.recovery.signature": "{{project}} team",
"emails.invitation.subject": "Innbyding til %s Team ved %s",
"emails.invitation.hello": "Hallo,",
"emails.invitation.body": "Denne meldinga ble sendt til deg fordi {{owner}} ynskja å invitera deg til å bli medlem av {{team}} team i {{project}}.",
"emails.invitation.footer": "Om du ikkje er interessert, kan du ignorera denne meldinga.",
"emails.invitation.thanks": "Takk,",
+ "emails.invitation.buttonText": "Godta invitasjon til {{team}}",
"emails.invitation.signature": "{{project}} team",
"locale.country.unknown": "Ukjend",
"countries.af": "Afghanistan",
diff --git a/app/config/locale/translations/or.json b/app/config/locale/translations/or.json
index efd516f23a..a8e08b8043 100644
--- a/app/config/locale/translations/or.json
+++ b/app/config/locale/translations/or.json
@@ -8,6 +8,7 @@
"emails.verification.body": "ଆପଣଙ୍କର ଇମେଲ୍ ଠିକଣା ଯାଞ୍ଚ କରିବାକୁ ଏହି ଲିଙ୍କ୍ ଅନୁସରଣ କରନ୍ତୁ |",
"emails.verification.footer": "ଯଦି ଆପଣ ଏହି ଠିକଣା ଯାଞ୍ଚ କରିବାକୁ କହି ନାହାଁନ୍ତି, ତେବେ ଆପଣ ଏହି ସନ୍ଦେଶକୁ ଉପେକ୍ଷା କରିପାରିବେ |",
"emails.verification.thanks": "ଧନ୍ୟବାଦ,",
+ "emails.verification.buttonText": "ଇମେଲ ଠିକଣା ନିଶ୍ଚିତ କରନ୍ତୁ",
"emails.verification.signature": "{{project}} ଦଳ",
"emails.magicSession.subject": "ଲଗଇନ୍ କରନ୍ତୁ",
"emails.magicSession.hello": "ନମସ୍କାର,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "ଆପଣଙ୍କର {{project}} ପାସୱାର୍ଡ ପୁନଃ ସେଟ୍ କରିବାକୁ ଏହି ଲିଙ୍କକୁ ଅନୁସରଣ କରନ୍ତୁ |",
"emails.recovery.footer": "ଯଦି ଆପଣ ଆପଣଙ୍କର ପାସୱାର୍ଡ ପୁନଃ ସେଟ୍ କରିବାକୁ କହି ନାହାଁନ୍ତି, ତେବେ ଆପଣ ଏହି ସନ୍ଦେଶକୁ ଉପେକ୍ଷା କରିପାରିବେ |",
"emails.recovery.thanks": "ଧନ୍ୟବାଦ,",
+ "emails.recovery.buttonText": "ପାସୱାର୍ଡ ପୁନଃସେଟ୍ କରନ୍ତୁ",
"emails.recovery.signature": "{{project}} ଦଳ",
"emails.invitation.subject": "%s ରେ %s ଦଳକୁ ନିମନ୍ତ୍ରଣ |",
"emails.invitation.hello": "ନମସ୍କାର,",
"emails.invitation.body": "ଏହି ମେଲ୍ ଆପଣଙ୍କୁ ପଠାଯାଇଥିଲା କାରଣ {{owner}} ଆପଣଙ୍କୁ {{project} ରେ {{team}} ଦଳର ସଦସ୍ୟ ହେବାକୁ ଆମନ୍ତ୍ରଣ କରିବାକୁ ଚାହୁଁଥିଲେ |",
"emails.invitation.footer": "ଯଦି ଆପଣ ଆଗ୍ରହୀ ନୁହଁନ୍ତି, ଆପଣ ଏହି ସନ୍ଦେଶକୁ ଅଣଦେଖା କରିପାରିବେ |",
"emails.invitation.thanks": "ଧନ୍ୟବାଦ,",
+ "emails.invitation.buttonText": "{{team}} ପାଇଁ ଆମନ୍ତ୍ରଣ ଗ୍ରହଣ କରନ୍ତୁ",
"emails.invitation.signature": "{{project}} ଦଳ",
"locale.country.unknown": "ଅଜ୍ଞାତ",
"countries.af": "ଆଫଗାନିସ୍ତାନ",
diff --git a/app/config/locale/translations/pl.json b/app/config/locale/translations/pl.json
index ee5811fb59..75bc3a24f9 100644
--- a/app/config/locale/translations/pl.json
+++ b/app/config/locale/translations/pl.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Przejdź do tego linku, aby zweryfikować swój adres e-mail.",
"emails.verification.footer": "Jeśli to nie Ty prosiłeś o zweryfikowanie tego adresu, zignoruj tę wiadomość.",
"emails.verification.thanks": "Dziękujemy,",
+ "emails.verification.buttonText": "Potwierdź adres e-mail",
"emails.verification.signature": "Zespół {{project}}",
"emails.magicSession.subject": "Logowanie",
"emails.magicSession.hello": "Cześć,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Przejdź do tego linku, aby zresetować hasło dla {{project}}.",
"emails.recovery.footer": "Jeśli to nie Ty prosiłeś o zresetowanie swojego hasła, zignoruj tę wiadomość.",
"emails.recovery.thanks": "Dziękujemy,",
+ "emails.recovery.buttonText": "Zresetuj hasło",
"emails.recovery.signature": "Zespół {{project}}",
"emails.invitation.subject": "Zaproszenie do zespołu %s w %s",
"emails.invitation.hello": "Cześć,",
"emails.invitation.body": "Otrzymujesz tę wiadomość, ponieważ {{owner}} zaprasza Cię do grona członków zespołu {{team}} w projekcie {{project}}.",
"emails.invitation.footer": "Jeśli nie jesteś zainteresowany, zignoruj tę wiadomość.",
"emails.invitation.thanks": "Dziękujemy,",
+ "emails.invitation.buttonText": "Zaakceptuj zaproszenie do {{team}}",
"emails.invitation.signature": "Zespół {{project}}",
"locale.country.unknown": "Nieznany",
"countries.af": "Afganistan",
diff --git a/app/config/locale/translations/pt-br.json b/app/config/locale/translations/pt-br.json
index a53ca79813..7e3af1d3f1 100644
--- a/app/config/locale/translations/pt-br.json
+++ b/app/config/locale/translations/pt-br.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Clique neste link para verificar o seu endereço de e-mail.",
"emails.verification.footer": "Se você não solicitou a verificação deste e-mail, ignore essa mensagem.",
"emails.verification.thanks": "Muito obrigado,",
+ "emails.verification.buttonText": "Confirmar endereço de e-mail",
"emails.verification.signature": "Time {{project}}",
"emails.magicSession.subject": "Login",
"emails.magicSession.hello": "Olá,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Clique neste link para redefinir sua senha do {{project}}.",
"emails.recovery.footer": "Se você não solicitou a redefinição da sua senha, você pode ignorar essa mensagem.",
"emails.recovery.thanks": "Muito obrigado,",
+ "emails.recovery.buttonText": "Redefinir senha",
"emails.recovery.signature": "Time {{project}}",
"emails.invitation.subject": "Convite para o Time %s em %s",
"emails.invitation.hello": "Olá,",
"emails.invitation.body": "Este e-mail foi enviado porque {{owner}} deseja convidar você a se tornar membro do Time {{team}} em {{project}}.",
"emails.invitation.footer": "Caso não tenha interesse, ignore essa mensagem.",
"emails.invitation.thanks": "Muito obrigado,",
+ "emails.invitation.buttonText": "Aceitar convite para {{team}}",
"emails.invitation.signature": "Time {{project}}",
"locale.country.unknown": "Desconhecido",
"countries.af": "Afeganistão",
diff --git a/app/config/locale/translations/pt-pt.json b/app/config/locale/translations/pt-pt.json
index d85dca9300..c13ce558bf 100644
--- a/app/config/locale/translations/pt-pt.json
+++ b/app/config/locale/translations/pt-pt.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Siga esta ligação para verificar o seu endereço de correio electrónico.",
"emails.verification.footer": "Se não pediu para verificar este endereço, pode ignorar esta mensagem.",
"emails.verification.thanks": "Obrigado,",
+ "emails.verification.buttonText": "Confirmar endereço de email",
"emails.verification.signature": "Equipa {{project}}",
"emails.magicSession.subject": "Login",
"emails.magicSession.hello": "Olá ,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Utilize este link para redefinir a palavra-passe do seu projecto {{project}}",
"emails.recovery.footer": "Se não pediu para redefinir a sua palavra-passe, pode ignorar esta mensagem.",
"emails.recovery.thanks": "Obrigado,",
+ "emails.recovery.buttonText": "Repor palavra-passe",
"emails.recovery.signature": "Equipa {{project}}",
"emails.invitation.subject": "Convite à equipa de %s às %s",
"emails.invitation.hello": "Olá,",
"emails.invitation.body": "Este correio foi-lhe enviado porque {{owner}} queria convidá-lo a tornar-se membro da equipa {{team}} da {{project}}.",
"emails.invitation.footer": "Se não estiver interessado, pode ignorar esta mensagem.",
"emails.invitation.thanks": "Obrigado,",
+ "emails.invitation.buttonText": "Aceitar convite para o {{team}}",
"emails.invitation.signature": "Equipa {{project}}",
"locale.country.unknown": "Desconhecido",
"countries.af": "Afeganistão",
diff --git a/app/config/locale/translations/ro.json b/app/config/locale/translations/ro.json
index 04cb22dd6b..88499ce3f6 100644
--- a/app/config/locale/translations/ro.json
+++ b/app/config/locale/translations/ro.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Click pe acest link pentru a valida adresa de email.",
"emails.verification.footer": "Dacă nu ai cerut validarea adresei de email, poți ignora acest mesaj.",
"emails.verification.thanks": "Mulțumim,",
+ "emails.verification.buttonText": "Confirmă adresa de email",
"emails.verification.signature": "Echipa {{project}}",
"emails.magicSession.subject": "Login",
"emails.magicSession.hello": "Bună ziua,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Click aici pentru a reseta parola pentru {{project}}",
"emails.recovery.footer": "Dacă nu ai cerut să îți schimbi parola, ignoră acest mesaj.",
"emails.recovery.thanks": "Mulțumim,",
+ "emails.recovery.buttonText": "Resetează parola",
"emails.recovery.signature": "Echipa {{project}}",
"emails.invitation.subject": "Invitatie catre %s Echipa la %s",
"emails.invitation.hello": "Bună ziua,",
"emails.invitation.body": "Acest email a fost trimis pentru că {{owner}} a vrut ca tu să devii membru al echipei {{team}} la {{project}}.",
"emails.invitation.footer": "Dacă nu esti interesat, poți ignora acest email.",
"emails.invitation.thanks": "Mulțumim,",
+ "emails.invitation.buttonText": "Acceptă invitația la {{team}}",
"emails.invitation.signature": "Echipa {{project}}",
"locale.country.unknown": "Necunoscut",
"countries.af": "Afghanistan",
diff --git a/app/config/locale/translations/ru.json b/app/config/locale/translations/ru.json
index 029aa06ee7..f61337de80 100644
--- a/app/config/locale/translations/ru.json
+++ b/app/config/locale/translations/ru.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Перейдите по ссылке, чтобы подтвердить свой адрес электронной почты.",
"emails.verification.footer": "Если вы не запрашивали подтверждение этого адреса, проигнорируйте это сообщение.",
"emails.verification.thanks": "Спасибо,",
+ "emails.verification.buttonText": "Подтвердить адрес электронной почты",
"emails.verification.signature": "команда {{project}}",
"emails.magicSession.subject": "Логин",
"emails.magicSession.hello": "Здравствуйте,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Перейдите по этой ссылке для того чтобы сбросить свой пароль для проекта {{project}}",
"emails.recovery.footer": "Если вы не запрашивали сброс пароля, проигнорируйте это сообщение.",
"emails.recovery.thanks": "Спасибо,",
+ "emails.recovery.buttonText": "Сбросить пароль",
"emails.recovery.signature": "команда {{project}}",
"emails.invitation.subject": "Приглашение в команду %s по проекту %s",
"emails.invitation.hello": "Здравствуйте,",
"emails.invitation.body": "Это письмо отправлено вам, потому что {{owner}} приглашает стать членом команды {{team}} в проекте {{project}}.",
"emails.invitation.footer": "Если вы не заинтересованы, проигнорируйте это сообщение.",
"emails.invitation.thanks": "Спасибо,",
+ "emails.invitation.buttonText": "Принять приглашение в {{team}}",
"emails.invitation.signature": "команда {{project}}",
"locale.country.unknown": "Неизвестно",
"countries.af": "Афганистан",
diff --git a/app/config/locale/translations/sa.json b/app/config/locale/translations/sa.json
index 7aa8c90d77..b3326110d1 100644
--- a/app/config/locale/translations/sa.json
+++ b/app/config/locale/translations/sa.json
@@ -8,6 +8,7 @@
"emails.verification.body": "ई-पत्रनिर्णायनार्थमिदं संयोगसूत्रमनुसरतु।",
"emails.verification.footer": "यदि अस्य संकेतस्य निर्णायनं नेष्यते तर्हि वात्र्तामिमामुपेक्षताम्।",
"emails.verification.thanks": "धन्यवादः,",
+ "emails.verification.buttonText": "ईमेल-पत्त्रं सुनिश्चित करें",
"emails.verification.signature": "{{project}} गणः",
"emails.magicSession.subject": "संप्रवेशः",
"emails.magicSession.hello": "अयि,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "{{project}} कूटशब्दपुनयाेजनाय संयोगमेनमनुसरतु।",
"emails.recovery.footer": "यदि कूटशब्दस्य पुनयाेजनं नेष्यते तर्हि वात्र्तामिमामुपेक्षताम्।",
"emails.recovery.thanks": "धन्यवादः,",
+ "emails.recovery.buttonText": "गुप्तशब्दं पुनः स्थापित करें",
"emails.recovery.signature": "{{project}} गणः",
"emails.invitation.subject": "गणस्य आमन्त्रणम् %s इति %s",
"emails.invitation.hello": "अयि भो,",
"emails.invitation.body": "{{owner}} {{team}} गणे {{project}} मध्ये भवद्योगदानमच्छितीति हेतोः पत्रमदिं भवत्सकाशं प्रेषतिम्।",
"emails.invitation.footer": "यदि भवदनिच्छा तर्हि वात्र्तामिमामुपेक्षताम्।",
"emails.invitation.thanks": "धन्यवादः,",
+ "emails.invitation.buttonText": "{{team}} निमन्त्रणं स्वीकुरुत",
"emails.invitation.signature": "{{project}} गणः",
"locale.country.unknown": "अज्ञातम् ",
"countries.af": "आफगानिस्थानम्",
diff --git a/app/config/locale/translations/sd.json b/app/config/locale/translations/sd.json
index 3f1f7678db..26c89a1770 100644
--- a/app/config/locale/translations/sd.json
+++ b/app/config/locale/translations/sd.json
@@ -8,6 +8,7 @@
"emails.verification.body": "پنھنجي اي ميل ايڊريس جي تصديق ڪرڻ لاءِ ھن لنڪ تي عمل ڪريو.",
"emails.verification.footer": "جيڪڏھن توھان نه پ askيا ھئا ھن ايڊريس جي تصديق ڪرڻ لاءِ ، توھان نظر انداز ڪري سگھوٿا ھن پيغام کي.",
"emails.verification.thanks": "مهرباني,",
+ "emails.verification.buttonText": "اي ميل پتو تصديق ڪريو",
"emails.verification.signature": "{{project}} ٽيم",
"emails.magicSession.subject": "لاگ ان",
"emails.magicSession.hello": "هي ,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "ھن لنڪ تي عمل ڪريو پنھنجو {{project}} پاسورڊ ري سيٽ ڪرڻ لاءِ.",
"emails.recovery.footer": "جيڪڏھن توھان نه پ پيو ھو پنھنجي پاسورڊ کي ري سيٽ ڪرڻ لاءِ ، توھان نظر انداز ڪري سگھوٿا ھن پيغام کي.",
"emails.recovery.thanks": "مهرباني,",
+ "emails.recovery.buttonText": "پاسورڊ ري سيٽ ڪريو",
"emails.recovery.signature": "{{project}} ٽيم",
"emails.invitation.subject": "%s ٽيم %s تيجي دعوت",
"emails.invitation.hello": "هيلو,",
"emails.invitation.body": "ھي اي ميل توھان ڏانھن موڪليو ويو آھي {اڪاڻ ته {{owner}} توھان کي دعوت ڏيڻ چاھي ٿو ته توھان {{team}} ٽيم جو ميمبر بڻجي {{project}} تي.",
"emails.invitation.footer": "جيڪڏھن توھان دلچسپي نٿا رکو ، توھان نظر انداز ڪري سگھوٿا ھن پيغام کي.",
"emails.invitation.thanks": "مهرباني,",
+ "emails.invitation.buttonText": "{{team}} جي دعوت قبول ڪريو",
"emails.invitation.signature": "{{project}} ٽيم",
"locale.country.unknown": "نامعلوم",
"countries.af": "افغانستان",
diff --git a/app/config/locale/translations/si.json b/app/config/locale/translations/si.json
index 536e8d3604..e2053407ea 100644
--- a/app/config/locale/translations/si.json
+++ b/app/config/locale/translations/si.json
@@ -8,6 +8,7 @@
"emails.verification.body": "ඔබගේ විද්යුත් තැපැල් ලිපිනය සත්යාපනය කිරීමට මෙම සම්බන්ධකය අනුගමනය කරන්න.",
"emails.verification.footer": "මෙම ලිපිනය සත්යාපනය කරන ලෙස ඔබ ඉල්ලුවේ නැත්නම්, ඔබට මෙම පණිවිඩය නොසලකා හැරිය හැක.",
"emails.verification.thanks": "ස්තුතියි,",
+ "emails.verification.buttonText": "ඊමේල් ලිපිනය තහවුරු කරන්න",
"emails.verification.signature": "{{project}} කණ්ඩායම",
"emails.magicSession.subject": "ප්රවේශ වන්න",
"emails.magicSession.hello": "හේයි,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "ඔබගේ {{project}} මුරපදය නැවත සැකසීමට මෙම සම්බන්ධකය අනුගමනය කරන්න.",
"emails.recovery.footer": "ඔබගේ මුරපදය නැවත සකසන ලෙස ඔබ ඉල්ලුවේ නැත්නම්, ඔබට මෙම පණිවිඩය නොසලකා හැරිය හැක.",
"emails.recovery.thanks": "ස්තුතියි,",
+ "emails.recovery.buttonText": "මුරපදය යළි පිහිටුවන්න",
"emails.recovery.signature": "{{project}} කණ්ඩායම",
"emails.invitation.subject": "%s කණ්ඩායමට ආරාධනා %s හි",
"emails.invitation.hello": "ආයුබෝවන්,",
"emails.invitation.body": "මෙම තැපැල් ඔබට එව්වේ, {{owner}} හට {{project}} හි {{team}} කණ්ඩායමේ සාමාජිකයෙකු වීමට ඔබට ආරාධනා කිරීමට අවශ්ය වූ බැවිනි.",
"emails.invitation.footer": "ඔබ උනන්දුවක් නොදක්වන්නේ නම්, ඔබට මෙම පණිවිඩය නොසලකා හැරිය හැක.",
"emails.invitation.thanks": "ස්තුතියි,",
+ "emails.invitation.buttonText": "{{team}} සඳහා ආරාධනය පිළිගෙනින්න",
"emails.invitation.signature": "{{project}} කණ්ඩායම",
"locale.country.unknown": "නොදන්නා",
"countries.af": "ඇෆ්ගනිස්ථානය",
diff --git a/app/config/locale/translations/sk.json b/app/config/locale/translations/sk.json
index 93c12c0881..1b41d8031d 100644
--- a/app/config/locale/translations/sk.json
+++ b/app/config/locale/translations/sk.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Použi tento link pre overenie svojej emailovej adresy.",
"emails.verification.footer": "Ak si nepožiadal o overenie tejto adresy, môžeš túto správu ignorovať.",
"emails.verification.thanks": "Ďakujeme.,",
+ "emails.verification.buttonText": "Potvrďte e-mailovú adresu",
"emails.verification.signature": "{{project}} tím",
"emails.magicSession.subject": "Prihlásenie",
"emails.magicSession.hello": "Ahoj,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Použi tento link pre obnovenie svojho {{project}} hesla.",
"emails.recovery.footer": "Ak si nepožiadal o obnovu svojho hesla, túto správu môžeš ignorovať.",
"emails.recovery.thanks": "Ďakujeme,",
+ "emails.recovery.buttonText": "Obnoviť heslo",
"emails.recovery.signature": "{{project}} tím",
"emails.invitation.subject": "Pozvánka do %s Tímu v %s",
"emails.invitation.hello": "Ahoj,",
"emails.invitation.body": "Tento email ti bol zaslaný, pretože {{owner}} ťa pozval, aby si sa stal členom {{team}} tímu v projekte {{project}}.",
"emails.invitation.footer": "Ak nemáš záujem, môžeš túto správu ignorovať.",
"emails.invitation.thanks": "Ďakujeme,",
+ "emails.invitation.buttonText": "Prijať pozvánku do {{team}}",
"emails.invitation.signature": "{{project}} tím",
"locale.country.unknown": "Neznámy",
"countries.af": "Afganistan",
diff --git a/app/config/locale/translations/sn.json b/app/config/locale/translations/sn.json
index d17a98ff42..9fcadfaa82 100644
--- a/app/config/locale/translations/sn.json
+++ b/app/config/locale/translations/sn.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Tevedza chinongedzo ichi kuti uratidze kuti kero iyi ndeyako.",
"emails.verification.footer": "Kana usina kukumbira kuti uratidze kuti kero iyi ndeyako, unogona kufuratira meseji iyi.",
"emails.verification.thanks": "Ndatenda,",
+ "emails.verification.buttonText": "Simbisa kero yeemail",
"emails.verification.signature": "Chikwata che{{project}}",
"emails.magicSession.subject": "Pinda",
"emails.magicSession.hello": "Hesi,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Baya chinongedzo ichi kuti uchinje pasiwedhi yako ye{{project}}.",
"emails.recovery.footer": "Kana usina kukumbira kuchinja pasiwedhi yako, unogona kufuratira meseji iyi.",
"emails.recovery.thanks": "Ndatenda,",
+ "emails.recovery.buttonText": "Gadzirisa password",
"emails.recovery.signature": "Chikwata che{{project}}",
"emails.invitation.subject": "Kukokwa kuchikwata che%s ku%s",
"emails.invitation.hello": "Mhoro,",
"emails.invitation.body": "Tsamba iyi yatumirwa kwauri nekuti {{owner}} anga achida kuti uve nhengo yechikwata che{{team}} pachirongwa che{{project}}.",
"emails.invitation.footer": "Kana usiri kufarira kuve nhengo yechikwata ichi, unogona kufuratira meseji iyi.",
"emails.invitation.thanks": "Ndatenda,",
+ "emails.invitation.buttonText": "Gamuchira kukokwa ku {{team}}",
"emails.invitation.signature": "Chikwata che{{project}}",
"locale.country.unknown": "Haizivikanwe",
"countries.af": "Afuganisitani",
diff --git a/app/config/locale/translations/sv.json b/app/config/locale/translations/sv.json
index 8997fd53f8..9bff513f0c 100644
--- a/app/config/locale/translations/sv.json
+++ b/app/config/locale/translations/sv.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Klicka på denna länk för att verifiera din email",
"emails.verification.footer": "Om du inte bad om att verifiera den här e-postadressen kan du ignorera detta mail.",
"emails.verification.thanks": "Tack,",
+ "emails.verification.buttonText": "Bekräfta e-postadress",
"emails.verification.signature": "{{project}} teamet",
"emails.magicSession.subject": "Logga in",
"emails.magicSession.hello": "Hej,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Klicka på denna länk för att återställa lösenordet på {{project}}",
"emails.recovery.footer": "Om du inte bad om att återställa ditt lösenord kan du ignorera detta mail.",
"emails.recovery.thanks": "Tack,",
+ "emails.recovery.buttonText": "Återställ lösenord",
"emails.recovery.signature": "{{project}} teamet",
"emails.invitation.subject": "Inbjudan till %s teamet på %s",
"emails.invitation.hello": "Hej,",
"emails.invitation.body": "Detta mail skickades till dig eftersom {{owner}} ville bjuda in dig att bli medlem i teamet {{team}} på {{project}}.",
"emails.invitation.footer": "Om du inte är intresserad kan du ignorera detta mail.",
"emails.invitation.thanks": "Tack,",
+ "emails.invitation.buttonText": "Acceptera inbjudan till {{team}}",
"emails.invitation.signature": "{{project}} teamet",
"locale.country.unknown": "Okänt",
"countries.af": "Afghanistan",
diff --git a/app/config/locale/translations/ta.json b/app/config/locale/translations/ta.json
index f0695867a9..4afcbe9b63 100644
--- a/app/config/locale/translations/ta.json
+++ b/app/config/locale/translations/ta.json
@@ -8,6 +8,7 @@
"emails.verification.body": "உங்கள் மின்னஞ்சல் முகவரியைச் சரிபார்க்க இந்த இணைப்பைப் பின்தொடரவும்.",
"emails.verification.footer": "இந்த முகவரியைச் சரிபார்க்கும்படி உங்களிடம் கேட்கப்படவில்லை என்றால், இந்தச் செய்தியை நீங்கள் புறக்கணிக்கலாம்.",
"emails.verification.thanks": "நன்றி,",
+ "emails.verification.buttonText": "மின்னஞ்சல் முகவரியை உறுதிப்படுத்தவும்",
"emails.verification.signature": "{{project}} குழு ",
"emails.magicSession.subject": "உள்நுழைய",
"emails.magicSession.hello": "ஏய்,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "மீட்டமைக்க இந்த இணைப்பைப் பின்தொடரவும் {{project}} கடவுச்சொல்.",
"emails.recovery.footer": "உங்கள் கடவுச்சொல்லை மீட்டமைக்கும்படி உங்களிடம் கேட்கப்படவில்லை என்றால், இந்தச் செய்தியை நீங்கள் புறக்கணிக்கலாம்.",
"emails.recovery.thanks": "நன்றி,",
+ "emails.recovery.buttonText": "கடவுச்சொல்லை மீட்டமைக்கவும்",
"emails.recovery.signature": "{{project}} குழு",
"emails.invitation.subject": "அழைப்பிதழ் %s குழு %s ",
"emails.invitation.hello": "வணக்கம்,",
"emails.invitation.body": "{{project}} இல் {{team}} குழுவில் உறுப்பினராக உங்களை {{owner}} அழைக்க விரும்புவதால், இந்த அஞ்சல் உங்களுக்கு அனுப்பப்பட்டது.",
"emails.invitation.footer": "உங்களுக்கு ஆர்வம் இல்லை என்றால், இந்த செய்தியை நீங்கள் புறக்கணிக்கலாம்.",
"emails.invitation.thanks": "நன்றி,",
+ "emails.invitation.buttonText": "{{team}} அழைப்பை ஏற்கவும்",
"emails.invitation.signature": "{{project}} குழு",
"locale.country.unknown": "அறியவில்லை",
"countries.af": "ஆப்கானித்தான்",
diff --git a/app/config/locale/translations/te.json b/app/config/locale/translations/te.json
index 870b0b82a2..4073fc72d9 100644
--- a/app/config/locale/translations/te.json
+++ b/app/config/locale/translations/te.json
@@ -8,6 +8,7 @@
"emails.verification.body": "ఈ లింక్ ద్వారా ఇమెయిల్ ని ధృవీకరించండి",
"emails.verification.footer": "మీరు ఈ చిరునామాను ధృవీకరించమని అడగనట్లయితే, మీరు ఈ సందేశాన్ని విస్మరించవచ్చు",
"emails.verification.thanks": "ధన్యవాదాలు,",
+ "emails.verification.buttonText": "ఇమెయిల్ చిరునామాను నిర్ధారించండి",
"emails.verification.signature": "{{project}} జట్",
"emails.magicSession.subject": "లాగిన్",
"emails.magicSession.hello": "నమస్కారము,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "మీ {{project}} పాస్వర్డ్ ని రీసెట్ చేయడానికి ఈ లింక్ ని అనుసరించండి",
"emails.recovery.footer": "మీరు మీ పాస్వర్డ్ ని రీసెట్ చేయమని అడగనట్లయితే, మీరు ఈ సందేశాన్ని విస్మరించవచ్చు",
"emails.recovery.thanks": "ధన్యవాదాల,",
+ "emails.recovery.buttonText": "పాస్వర్డ్ను రీసెట్ చేయండి",
"emails.recovery.signature": "{{project}} జట్",
"emails.invitation.subject": "%s వద్ద %s బృందానికి ఆహ్వానం",
"emails.invitation.hello": "నమస్కారమ,",
"emails.invitation.body": "{{owner}} మిమ్మల్ని {{project}} లో {{team}} బృందంలో సభ్యునిగా ఉండమని ఆహ్వానించాలనుకుంటున్నందున ఈ మెయిల్ మీకు పంపబడింది.",
"emails.invitation.footer": "మీకు ఆసక్తి లేకుంటే, మీరు ఈ సందేశాన్ని విస్మరించవచ్చు.",
"emails.invitation.thanks": "ధన్యవాదాల,",
+ "emails.invitation.buttonText": "{{team}} కు ఆహ్వానాన్ని ఆమోదించండి",
"emails.invitation.signature": "{{project}} జట్",
"locale.country.unknown": "తెలియని",
"countries.af": "ఆఫ్ఘనిస్తాన్",
diff --git a/app/config/locale/translations/th.json b/app/config/locale/translations/th.json
index 5a53b16055..4003ece666 100644
--- a/app/config/locale/translations/th.json
+++ b/app/config/locale/translations/th.json
@@ -8,6 +8,7 @@
"emails.verification.body": "กดเข้าไปที่ลิงก์นี้เพื่อยืนยันอีเมลของท่าน",
"emails.verification.footer": "หากท่านไม่ได้ต้องการที่จะยืนยันอีเมลนี้ ท่านสามารถเพิกเฉยข้อความนี้ได้",
"emails.verification.thanks": "ขอบคุณ",
+ "emails.verification.buttonText": "ยืนยันที่อยู่อีเมล",
"emails.verification.signature": "ทีม {{project}}",
"emails.magicSession.subject": "เข้าสู่ระบบ",
"emails.magicSession.hello": "เรียนผู้ใช้งาน",
@@ -20,12 +21,14 @@
"emails.recovery.body": "กดเข้าไปที่ลิงก์นี้เพื่อรีเซ็ตรหัสผ่านสำหรับโปรเจกต์ {{project}} ของท่าน",
"emails.recovery.footer": "หากท่านไม่ได้ต้องการที่จะรีเซ็ตรหัสผ่านของท่าน ท่านสามารถเพิกเฉยข้อความนี้ได้",
"emails.recovery.thanks": "ขอบคุณ",
+ "emails.recovery.buttonText": "รีเซ็ตรหัสผ่าน",
"emails.recovery.signature": "ทีม {{project}}",
"emails.invitation.subject": "เรียนเชิญเข้าร่วม ทีม %s จากโปรเจกต์ %s",
"emails.invitation.hello": "สวัสดี",
"emails.invitation.body": "ท่านได้รับอีเมลฉบับนี้เนื่องจาก {{owner}} ต้องการที่จะเชิญชวนคุณเข้าร่วมเป็นส่วนหนึ่งของ ทีม {{team}} จากโปรเจกต์ {{project}}",
"emails.invitation.footer": "หากท่านไม่ได้สนใจที่จะเข้าร่วม ท่านสามารถเพิกเฉยข้อความนี้ได้",
"emails.invitation.thanks": "ขอบคุณ",
+ "emails.invitation.buttonText": "ยอมรับคำเชิญเข้าร่วม {{team}}",
"emails.invitation.signature": "ทีม {{project}}",
"locale.country.unknown": "ไม่ทราบ",
"countries.af": "อัฟกานิสถาน",
diff --git a/app/config/locale/translations/tl.json b/app/config/locale/translations/tl.json
index 6d0be01095..27ea6c088f 100644
--- a/app/config/locale/translations/tl.json
+++ b/app/config/locale/translations/tl.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Sundin ang link na ito upang ma-verify ang iyong email address.",
"emails.verification.footer": "Kung hindi mo hiningi na i-verify ang address na ito, maaari mong balewalain ang mensahe na ito.",
"emails.verification.thanks": "Salamat,",
+ "emails.verification.buttonText": "Kumpirmahin ang email address",
"emails.verification.signature": "Pangkat ng {{project}}",
"emails.magicSession.subject": "Mag log in",
"emails.magicSession.hello": "Kamusta ,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Sundin ang link na ito upang i-reset ang password ng iyong {{project}}.",
"emails.recovery.footer": "Kung hindi mo hiningi na i-reset ang iyong password, maaari mong balewalain ang mensahe na ito.",
"emails.recovery.thanks": "Salamat,",
+ "emails.recovery.buttonText": "I-reset ang password",
"emails.recovery.signature": "Pangkat ng {{project}}",
"emails.invitation.subject": "Imbitasyon para sa Pangkat %s sa %s",
"emails.invitation.hello": "Kamusta,",
"emails.invitation.body": "Ipinadala sa iyo ang mail na ito dahil gusto kang imbitahan ni {{owner}} na maging miyembro ng Pangkat {{team}} sa ilalim ng proyektong {{project}}.",
"emails.invitation.footer": "Kung ikaw ay hindi interesado, maaari mong balewalain ang mensaheng ito.",
"emails.invitation.thanks": "Salamat,",
+ "emails.invitation.buttonText": "Tanggapin ang paanyaya sa {{team}}",
"emails.invitation.signature": "Pangkat ng {{project}}",
"locale.country.unknown": "Hindi kilala",
"countries.af": "Apganistan",
diff --git a/app/config/locale/translations/tr.json b/app/config/locale/translations/tr.json
index 115050c2e2..a7183152b6 100644
--- a/app/config/locale/translations/tr.json
+++ b/app/config/locale/translations/tr.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Eposta adresini doğrulamak için bu bağlantıyı kullanın.",
"emails.verification.footer": "Eğer bu eposta adresini doğrulamak isteyen siz değilseniz devam etmeyin.",
"emails.verification.thanks": "Teşekkürler,",
+ "emails.verification.buttonText": "E-posta adresini doğrula",
"emails.verification.signature": "{{project}} takımı",
"emails.magicSession.subject": "Giriş",
"emails.magicSession.hello": "Merhaba,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "{{project}} şifrenizi sıfırlamak için bu bağlantıyı kullanın.",
"emails.recovery.footer": "Eğer şifre sıfırlama talebinde bulunmadıysanız devam etmeyin.",
"emails.recovery.thanks": "Teşekkürler,",
+ "emails.recovery.buttonText": "Şifreyi sıfırla",
"emails.recovery.signature": "{{project}} takımı",
"emails.invitation.subject": "%s üzerinde %s Takımına Davet",
"emails.invitation.hello": "Merhaba,",
"emails.invitation.body": "Bu epostayı aldınız, çünkü {{owner}} sizi {{project}} üzerinde {{team}} takımının üyesi olmaya davet etti.",
"emails.invitation.footer": "Eğer ilgilenmiyorsanız devam etmeyin.",
"emails.invitation.thanks": "Teşekkürler,",
+ "emails.invitation.buttonText": "{{team}}'e daveti kabul et",
"emails.invitation.signature": "{{project}} takımı",
"locale.country.unknown": "Bilinmeyen",
"countries.af": "Afganistan",
diff --git a/app/config/locale/translations/uk.json b/app/config/locale/translations/uk.json
index 3f66bd1c58..daa003754d 100644
--- a/app/config/locale/translations/uk.json
+++ b/app/config/locale/translations/uk.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Перейдіть за цим посиланням, щоб підтвердити свою електронну адресу.",
"emails.verification.footer": "Якщо ви не запитували підтвердження цієї адреси, ви можете ігнорувати це повідомлення.",
"emails.verification.thanks": "Дякуємо,",
+ "emails.verification.buttonText": "Підтвердити адресу електронної пошти",
"emails.verification.signature": "команда {{project}}",
"emails.magicSession.subject": "Логін",
"emails.magicSession.hello": "Вітаємо,",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Перейдіть за цим посиланням для того щоб скинути свій пароль для проекту {{project}}",
"emails.recovery.footer": "Якщо ви не запитували скидання паролю, проігноруйте це повідомлення.",
"emails.recovery.thanks": "Дякуємо,",
+ "emails.recovery.buttonText": "Скинути пароль",
"emails.recovery.signature": "команда {{project}}",
"emails.invitation.subject": "Запрошення до %s Команди у %s",
"emails.invitation.hello": "Вітаємо,",
"emails.invitation.body": "Цей лист був надісланий вам тому що {{owner}} запрошує вас стати членом команди {{team}} у проекті {{project}}.",
"emails.invitation.footer": "Якщо ви не зацікавлені, проігноруйте це повідомлення.",
"emails.invitation.thanks": "Дякуємо,",
+ "emails.invitation.buttonText": "Прийняти запрошення до {{team}}",
"emails.invitation.signature": "команда {{project}}",
"locale.country.unknown": "Невідомо",
"countries.af": "Афганістан",
diff --git a/app/config/locale/translations/ur.json b/app/config/locale/translations/ur.json
index 9d6aa47762..8823e0da2e 100644
--- a/app/config/locale/translations/ur.json
+++ b/app/config/locale/translations/ur.json
@@ -8,6 +8,7 @@
"emails.verification.body": "براہ کرم اپنے ای میل کی تصدیق کے لیے درج ذیل لنک پر عمل کریں۔",
"emails.verification.footer": "اگر آپ نے اس پتے کی تصدیق کے لیے نہیں کہا تو آپ اس پیغام کو نظر انداز کر سکتے ہیں۔",
"emails.verification.thanks": "شکریہ،",
+ "emails.verification.buttonText": "ای میل پتہ کی تصدیق کریں",
"emails.verification.signature": "ٹیم۔ {{project}}",
"emails.magicSession.subject": "اگ ان کریں",
"emails.magicSession.hello": "خوش آمدید،",
@@ -20,13 +21,15 @@
"emails.recovery.body": "{{project}} کا پاس ورڈ تبدیل کرنے کے لیے درج ذیل لنک پر عمل کریں",
"emails.recovery.footer": "اگر آپ نے اپنا پاس ورڈ دوبارہ ترتیب دینے کے لیے نہیں کہا تو آپ اس پیغام کو نظر انداز کر سکتے ہیں۔",
"emails.recovery.thanks": "شکریہ،",
+ "emails.recovery.buttonText": "پاس ورڈ ری سیٹ کریں",
"emails.recovery.signature": "ٹیم۔ {{project}}",
"emails.invitation.subject": "%s پر %s ٹیم کو دعوت",
"emails.invitation.hello": "خوش آمدید،",
"emails.invitation.body": "یہ پیغام آپ کو اس لیے بھیجا گیا تھا کہ {{owner}} نے آپ کو {{project}} میں {{team}} ٹیم کا رکن بننے کی دعوت بھیجی",
"emails.invitation.footer": "اگر آپ دلچسپی نہیں رکھتے تو آپ اس پیغام کو نظر انداز کر سکتے ہیں۔",
"emails.invitation.thanks": "شکریہ،",
- "emails.invitation.signature": "ٹیم۔ {{project}",
+ "emails.invitation.buttonText": "{{team}} کی دعوت قبول کریں",
+ "emails.invitation.signature": "ٹیم۔ {{project}}",
"locale.country.unknown": "نامعلوم",
"countries.af": "افغانستان",
"countries.ao": "انگولا",
diff --git a/app/config/locale/translations/vi.json b/app/config/locale/translations/vi.json
index 76a545a1d4..e9168d9ab8 100644
--- a/app/config/locale/translations/vi.json
+++ b/app/config/locale/translations/vi.json
@@ -8,6 +8,7 @@
"emails.verification.body": "Nhấn vào đường dẫn sau để xác minh địa chỉ email của bạn.",
"emails.verification.footer": "Nếu bạn không yêu cầu xác minh tài khoản, bạn có thể bỏ qua email này.",
"emails.verification.thanks": "Cảm ơn",
+ "emails.verification.buttonText": "Xác nhận địa chỉ email",
"emails.verification.signature": "Nhóm {{project}}",
"emails.magicSession.subject": "Đăng nhập",
"emails.magicSession.hello": "Chào",
@@ -20,12 +21,14 @@
"emails.recovery.body": "Nhấn vào đường dẫn sau để thiết lập lại mật khẩu {{project}} của bạn.",
"emails.recovery.footer": "Nếu bạn không yêu cầu thiết lập lại mật khẩu, bạn có thể bỏ qua email này.",
"emails.recovery.thanks": "Cảm ơn",
+ "emails.recovery.buttonText": "Đặt lại mật khẩu",
"emails.recovery.signature": "Nhóm {{project}}",
"emails.invitation.subject": "Lời mời tham gia nhóm %s tại %s",
"emails.invitation.hello": "Xin chào",
"emails.invitation.body": "Email này được gửi cho bạn vì {{owner}} muốn mời bạn trở thành một thành viên của nhóm {{team}} tại {{project}}.",
"emails.invitation.footer": "Nếu bạn không quan tâm, bạn có thể bỏ qua email này.",
"emails.invitation.thanks": "Cảm ơn",
+ "emails.invitation.buttonText": "Chấp nhận lời mời vào {{team}}",
"emails.invitation.signature": "Nhóm {{project}}",
"locale.country.unknown": "Không xác định",
"countries.af": "Afghanistan",
diff --git a/app/config/locale/translations/zh-cn.json b/app/config/locale/translations/zh-cn.json
index 5e35a89bfe..554b506e9e 100644
--- a/app/config/locale/translations/zh-cn.json
+++ b/app/config/locale/translations/zh-cn.json
@@ -8,6 +8,7 @@
"emails.verification.body": "点此链接验证您的电子邮件地址。",
"emails.verification.footer": "如果您没有要求验证此地址，则可忽略此消息。",
"emails.verification.thanks": "谢谢、",
+ "emails.verification.buttonText": "确认邮箱地址",
"emails.verification.signature": "{{project}} 团队",
"emails.magicSession.subject": "登录",
"emails.magicSession.hello": "你好、",
@@ -20,12 +21,14 @@
"emails.recovery.body": "点此链接重置您的 {{project}} 密码。",
"emails.recovery.footer": "如果您没有要求重置密码，则可以忽略此消息。",
"emails.recovery.thanks": "谢谢、",
+ "emails.recovery.buttonText": "重置密码",
"emails.recovery.signature": "{{project}} 团队",
"emails.invitation.subject": "邀请 %s 团队在 %s",
"emails.invitation.hello": "你好、",
"emails.invitation.body": "这封邮件发送给您是因为 {{owner}} 想邀请您成为 {{team}} 团队在 {{project}}.",
"emails.invitation.footer": "如果您不感兴趣，可以忽略此消息。",
"emails.invitation.thanks": "谢谢、",
+ "emails.invitation.buttonText": "接受加入 {{team}} 的邀请",
"emails.invitation.signature": "{{project}} 团队",
"locale.country.unknown": "未知",
"countries.af": "阿富汗",
diff --git a/app/config/locale/translations/zh-tw.json b/app/config/locale/translations/zh-tw.json
index 146dd0a401..bb9868d679 100644
--- a/app/config/locale/translations/zh-tw.json
+++ b/app/config/locale/translations/zh-tw.json
@@ -8,6 +8,7 @@
"emails.verification.body": "按照此連結驗證您的電子郵件地址。",
"emails.verification.footer": "如果您沒有要求驗證此地址，則可以忽略此消息。",
"emails.verification.thanks": "謝謝、",
+ "emails.verification.buttonText": "確認電子郵件地址",
"emails.verification.signature": "{{project}} 團隊",
"emails.magicSession.subject": "登入",
"emails.magicSession.hello": "嗨、",
@@ -20,12 +21,14 @@
"emails.recovery.body": "按照此連結重置您的 {{project}} 密碼。",
"emails.recovery.footer": "如果您沒有要求重置密碼，則可以忽略此消息。",
"emails.recovery.thanks": "謝謝、",
+ "emails.recovery.buttonText": "重設密碼",
"emails.recovery.signature": "{{project}} 團隊",
"emails.invitation.subject": "邀請 %s 團隊在 %s",
"emails.invitation.hello": "您好、",
"emails.invitation.body": "發送這封郵件給您是因為 {{owner}} 想邀請您成為 {{team}} 團隊在 {{project}}。",
"emails.invitation.footer": "如果您不感興趣，可以忽略此消息。",
"emails.invitation.thanks": "謝謝、",
+ "emails.invitation.buttonText": "接受加入 {{team}} 的邀請",
"emails.invitation.signature": "{{project}} 團隊",
"locale.country.unknown": "未知",
"countries.af": "阿富汗",
diff --git a/app/config/platforms.php b/app/config/platforms.php
index f08401e8fa..96d5426515 100644
--- a/app/config/platforms.php
+++ b/app/config/platforms.php
@@ -134,7 +134,7 @@ return [
[
'key' => 'react-native',
'name' => 'React Native',
- 'version' => '0.9.1',
+ 'version' => '0.10.0',
'url' => 'https://github.com/appwrite/sdk-for-react-native',
'package' => 'https://npmjs.com/package/react-native-appwrite',
'enabled' => true,
@@ -217,7 +217,7 @@ return [
[
'key' => 'cli',
'name' => 'Command Line',
- 'version' => '8.0.0',
+ 'version' => '8.1.0',
'url' => 'https://github.com/appwrite/sdk-for-cli',
'package' => 'https://www.npmjs.com/package/appwrite-cli',
'enabled' => true,
diff --git a/app/config/roles.php b/app/config/roles.php
index bccc2837f5..4b06e0a6c1 100644
--- a/app/config/roles.php
+++ b/app/config/roles.php
@@ -14,6 +14,8 @@ $member = [
'teams.write',
'documents.read',
'documents.write',
+ 'rows.read',
+ 'rows.write',
'files.read',
'files.write',
'projects.read',
@@ -37,6 +39,8 @@ $admins = [
'teams.write',
'documents.read',
'documents.write',
+ 'rows.read',
+ 'rows.write',
'files.read',
'files.write',
'buckets.read',
@@ -47,6 +51,8 @@ $admins = [
'databases.write',
'collections.read',
'collections.write',
+ 'tables.read',
+ 'tables.write',
'platforms.read',
'platforms.write',
'projects.write',
@@ -97,6 +103,8 @@ return [
'sessions.write',
'documents.read',
'documents.write',
+ 'rows.read',
+ 'rows.write',
'files.read',
'files.write',
'locale.read',
diff --git a/app/config/scopes.php b/app/config/scopes.php
index 7dea7b1cd5..d90ca2eabf 100644
--- a/app/config/scopes.php
+++ b/app/config/scopes.php
@@ -28,12 +28,24 @@ return [ // List of publicly visible scopes
'collections.write' => [
'description' => 'Access to create, update, and delete your project\'s database collections',
],
+ 'tables.read' => [
+ 'description' => 'Access to read your project\'s database tables',
+ ],
+ 'tables.write' => [
+ 'description' => 'Access to create, update, and delete your project\'s database tables',
+ ],
'attributes.read' => [
'description' => 'Access to read your project\'s database collection\'s attributes',
],
'attributes.write' => [
'description' => 'Access to create, update, and delete your project\'s database collection\'s attributes',
],
+ 'columns.read' => [
+ 'description' => 'Access to read your project\'s database table\'s columns',
+ ],
+ 'columns.write' => [
+ 'description' => 'Access to create, update, and delete your project\'s database table\'s columns',
+ ],
'indexes.read' => [
'description' => 'Access to read your project\'s database collection\'s indexes',
],
@@ -46,6 +58,12 @@ return [ // List of publicly visible scopes
'documents.write' => [
'description' => 'Access to create, update, and delete your project\'s database documents',
],
+ 'rows.read' => [
+ 'description' => 'Access to read your project\'s database rows',
+ ],
+ 'rows.write' => [
+ 'description' => 'Access to create, update, and delete your project\'s database rows',
+ ],
'files.read' => [
'description' => 'Access to read your project\'s storage files and preview images',
],
diff --git a/app/config/services.php b/app/config/services.php
index 9fef123f36..2dfc97fcbe 100644
--- a/app/config/services.php
+++ b/app/config/services.php
@@ -58,7 +58,7 @@ return [
'name' => 'Databases',
'subtitle' => 'The Databases service allows you to create structured collections of documents, query and filter lists of documents',
'description' => '/docs/services/databases.md',
- 'controller' => 'api/databases.php',
+ 'controller' => '', // Uses modules
'sdk' => true,
'docs' => true,
'docsUrl' => 'https://appwrite.io/docs/client/databases',
diff --git a/app/config/specs/open-api3-1.7.x-client.json b/app/config/specs/open-api3-1.7.x-client.json
index bbb78c6c66..11fd80fda8 100644
--- a/app/config/specs/open-api3-1.7.x-client.json
+++ b/app/config/specs/open-api3-1.7.x-client.json
@@ -4666,7 +4666,7 @@
"tags": [
"databases"
],
- "description": "Create or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
"responses": {
"200": {
"description": "Document",
@@ -6595,7 +6595,8 @@
"png",
"webp",
"heic",
- "avif"
+ "avif",
+ "gif"
],
"x-enum-name": "ImageFormat",
"x-enum-keys": [],
diff --git a/app/config/specs/open-api3-1.7.x-console.json b/app/config/specs/open-api3-1.7.x-console.json
index 90ef137fc2..48440caac4 100644
--- a/app/config/specs/open-api3-1.7.x-console.json
+++ b/app/config/specs/open-api3-1.7.x-console.json
@@ -8071,7 +8071,7 @@
"model": "#\/components\/schemas\/documentList"
}
],
- "description": "Create new Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console."
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate new Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console."
}
],
"auth": {
@@ -8151,7 +8151,7 @@
"tags": [
"databases"
],
- "description": "Create or update Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.\n",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
"responses": {
"200": {
"description": "Documents List",
@@ -8242,7 +8242,7 @@
"tags": [
"databases"
],
- "description": "Update all documents that match your queries, if no queries are submitted then all documents are updated. You can pass only specific fields to be updated.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nUpdate all documents that match your queries, if no queries are submitted then all documents are updated. You can pass only specific fields to be updated.",
"responses": {
"200": {
"description": "Documents List",
@@ -8335,7 +8335,7 @@
"tags": [
"databases"
],
- "description": "Bulk delete documents using queries, if no queries are passed then all documents are deleted.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nBulk delete documents using queries, if no queries are passed then all documents are deleted.",
"responses": {
"200": {
"description": "Documents List",
@@ -8520,7 +8520,7 @@
"tags": [
"databases"
],
- "description": "Create or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
"responses": {
"200": {
"description": "Document",
@@ -9767,6 +9767,7 @@
"dart-3.1",
"dart-3.3",
"dart-3.5",
+ "dart-3.8",
"dotnet-6.0",
"dotnet-7.0",
"dotnet-8.0",
@@ -9792,7 +9793,8 @@
"static-1",
"flutter-3.24",
"flutter-3.27",
- "flutter-3.29"
+ "flutter-3.29",
+ "flutter-3.32"
],
"x-enum-name": null,
"x-enum-keys": []
@@ -10395,6 +10397,7 @@
"dart-3.1",
"dart-3.3",
"dart-3.5",
+ "dart-3.8",
"dotnet-6.0",
"dotnet-7.0",
"dotnet-8.0",
@@ -10420,7 +10423,8 @@
"static-1",
"flutter-3.24",
"flutter-3.27",
- "flutter-3.29"
+ "flutter-3.29",
+ "flutter-3.32"
],
"x-enum-name": null,
"x-enum-keys": []
@@ -25446,12 +25450,33 @@
"Temporary Redirect 307",
"Permanent Redirect 308"
]
+ },
+ "resourceId": {
+ "type": "string",
+ "description": "ID of parent resource.",
+ "x-example": ""
+ },
+ "resourceType": {
+ "type": "string",
+ "description": "Type of parent resource.",
+ "x-example": "site",
+ "enum": [
+ "site",
+ "function"
+ ],
+ "x-enum-name": "ProxyResourceType",
+ "x-enum-keys": [
+ "Site",
+ "Function"
+ ]
}
},
"required": [
"domain",
"url",
- "statusCode"
+ "statusCode",
+ "resourceId",
+ "resourceType"
]
}
}
@@ -25936,6 +25961,7 @@
"dart-3.1",
"dart-3.3",
"dart-3.5",
+ "dart-3.8",
"dotnet-6.0",
"dotnet-7.0",
"dotnet-8.0",
@@ -25961,7 +25987,8 @@
"static-1",
"flutter-3.24",
"flutter-3.27",
- "flutter-3.29"
+ "flutter-3.29",
+ "flutter-3.32"
],
"x-enum-name": null,
"x-enum-keys": []
@@ -26580,6 +26607,7 @@
"dart-3.1",
"dart-3.3",
"dart-3.5",
+ "dart-3.8",
"dotnet-6.0",
"dotnet-7.0",
"dotnet-8.0",
@@ -26605,7 +26633,8 @@
"static-1",
"flutter-3.24",
"flutter-3.27",
- "flutter-3.29"
+ "flutter-3.29",
+ "flutter-3.32"
],
"x-enum-name": null,
"x-enum-keys": []
@@ -29364,7 +29393,8 @@
"png",
"webp",
"heic",
- "avif"
+ "avif",
+ "gif"
],
"x-enum-name": "ImageFormat",
"x-enum-keys": [],
@@ -34846,6 +34876,17 @@
"default": ""
},
"in": "query"
+ },
+ {
+ "name": "providerReference",
+ "description": "Git reference (branch, tag, commit) to get contents from",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "x-example": "",
+ "default": ""
+ },
+ "in": "query"
}
]
}
diff --git a/app/config/specs/open-api3-1.7.x-server.json b/app/config/specs/open-api3-1.7.x-server.json
index 1ae9328864..4a6a4f3b4f 100644
--- a/app/config/specs/open-api3-1.7.x-server.json
+++ b/app/config/specs/open-api3-1.7.x-server.json
@@ -7552,7 +7552,7 @@
"model": "#\/components\/schemas\/documentList"
}
],
- "description": "Create new Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console."
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate new Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console."
}
],
"auth": {
@@ -7634,7 +7634,7 @@
"tags": [
"databases"
],
- "description": "Create or update Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.\n",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
"responses": {
"200": {
"description": "Documents List",
@@ -7726,7 +7726,7 @@
"tags": [
"databases"
],
- "description": "Update all documents that match your queries, if no queries are submitted then all documents are updated. You can pass only specific fields to be updated.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nUpdate all documents that match your queries, if no queries are submitted then all documents are updated. You can pass only specific fields to be updated.",
"responses": {
"200": {
"description": "Documents List",
@@ -7820,7 +7820,7 @@
"tags": [
"databases"
],
- "description": "Bulk delete documents using queries, if no queries are passed then all documents are deleted.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nBulk delete documents using queries, if no queries are passed then all documents are deleted.",
"responses": {
"200": {
"description": "Documents List",
@@ -8008,7 +8008,7 @@
"tags": [
"databases"
],
- "description": "Create or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
"responses": {
"200": {
"description": "Document",
@@ -8844,6 +8844,7 @@
"dart-3.1",
"dart-3.3",
"dart-3.5",
+ "dart-3.8",
"dotnet-6.0",
"dotnet-7.0",
"dotnet-8.0",
@@ -8869,7 +8870,8 @@
"static-1",
"flutter-3.24",
"flutter-3.27",
- "flutter-3.29"
+ "flutter-3.29",
+ "flutter-3.32"
],
"x-enum-name": null,
"x-enum-keys": []
@@ -9244,6 +9246,7 @@
"dart-3.1",
"dart-3.3",
"dart-3.5",
+ "dart-3.8",
"dotnet-6.0",
"dotnet-7.0",
"dotnet-8.0",
@@ -9269,7 +9272,8 @@
"static-1",
"flutter-3.24",
"flutter-3.27",
- "flutter-3.29"
+ "flutter-3.29",
+ "flutter-3.32"
],
"x-enum-name": null,
"x-enum-keys": []
@@ -17490,6 +17494,7 @@
"dart-3.1",
"dart-3.3",
"dart-3.5",
+ "dart-3.8",
"dotnet-6.0",
"dotnet-7.0",
"dotnet-8.0",
@@ -17515,7 +17520,8 @@
"static-1",
"flutter-3.24",
"flutter-3.27",
- "flutter-3.29"
+ "flutter-3.29",
+ "flutter-3.32"
],
"x-enum-name": null,
"x-enum-keys": []
@@ -17906,6 +17912,7 @@
"dart-3.1",
"dart-3.3",
"dart-3.5",
+ "dart-3.8",
"dotnet-6.0",
"dotnet-7.0",
"dotnet-8.0",
@@ -17931,7 +17938,8 @@
"static-1",
"flutter-3.24",
"flutter-3.27",
- "flutter-3.29"
+ "flutter-3.29",
+ "flutter-3.32"
],
"x-enum-name": null,
"x-enum-keys": []
@@ -20646,7 +20654,8 @@
"png",
"webp",
"heic",
- "avif"
+ "avif",
+ "gif"
],
"x-enum-name": "ImageFormat",
"x-enum-keys": [],
diff --git a/app/config/specs/open-api3-latest-client.json b/app/config/specs/open-api3-latest-client.json
index 73a027f4bb..b9fcb4672d 100644
--- a/app/config/specs/open-api3-latest-client.json
+++ b/app/config/specs/open-api3-latest-client.json
@@ -4492,29 +4492,6 @@
}
],
"description": "Create a new Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console."
- },
- {
- "name": "createDocuments",
- "auth": {
- "Key": []
- },
- "parameters": [
- "databaseId",
- "collectionId",
- "documents"
- ],
- "required": [
- "databaseId",
- "collectionId",
- "documents"
- ],
- "responses": [
- {
- "code": 201,
- "model": "#\/components\/schemas\/documentList"
- }
- ],
- "description": "Create new Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console."
}
],
"auth": {
@@ -4691,7 +4668,7 @@
"tags": [
"databases"
],
- "description": "Create or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
"responses": {
"200": {
"description": "Document",
diff --git a/app/config/specs/open-api3-latest-console.json b/app/config/specs/open-api3-latest-console.json
index 92ba5c6829..a950dd37dd 100644
--- a/app/config/specs/open-api3-latest-console.json
+++ b/app/config/specs/open-api3-latest-console.json
@@ -8074,7 +8074,7 @@
"model": "#\/components\/schemas\/documentList"
}
],
- "description": "Create new Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console."
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate new Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console."
}
],
"auth": {
@@ -8154,7 +8154,7 @@
"tags": [
"databases"
],
- "description": "Create or update Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.\n",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
"responses": {
"200": {
"description": "Documents List",
@@ -8246,7 +8246,7 @@
"tags": [
"databases"
],
- "description": "Update all documents that match your queries, if no queries are submitted then all documents are updated. You can pass only specific fields to be updated.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nUpdate all documents that match your queries, if no queries are submitted then all documents are updated. You can pass only specific fields to be updated.",
"responses": {
"200": {
"description": "Documents List",
@@ -8340,7 +8340,7 @@
"tags": [
"databases"
],
- "description": "Bulk delete documents using queries, if no queries are passed then all documents are deleted.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nBulk delete documents using queries, if no queries are passed then all documents are deleted.",
"responses": {
"200": {
"description": "Documents List",
@@ -8526,7 +8526,7 @@
"tags": [
"databases"
],
- "description": "Create or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
"responses": {
"200": {
"description": "Document",
diff --git a/app/config/specs/open-api3-latest-server.json b/app/config/specs/open-api3-latest-server.json
index 3e9b87fdf1..8b570f6b48 100644
--- a/app/config/specs/open-api3-latest-server.json
+++ b/app/config/specs/open-api3-latest-server.json
@@ -7555,7 +7555,7 @@
"model": "#\/components\/schemas\/documentList"
}
],
- "description": "Create new Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console."
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate new Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console."
}
],
"auth": {
@@ -7637,7 +7637,7 @@
"tags": [
"databases"
],
- "description": "Create or update Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.\n",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
"responses": {
"200": {
"description": "Documents List",
@@ -7730,7 +7730,7 @@
"tags": [
"databases"
],
- "description": "Update all documents that match your queries, if no queries are submitted then all documents are updated. You can pass only specific fields to be updated.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nUpdate all documents that match your queries, if no queries are submitted then all documents are updated. You can pass only specific fields to be updated.",
"responses": {
"200": {
"description": "Documents List",
@@ -7825,7 +7825,7 @@
"tags": [
"databases"
],
- "description": "Bulk delete documents using queries, if no queries are passed then all documents are deleted.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nBulk delete documents using queries, if no queries are passed then all documents are deleted.",
"responses": {
"200": {
"description": "Documents List",
@@ -8014,7 +8014,7 @@
"tags": [
"databases"
],
- "description": "Create or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
"responses": {
"200": {
"description": "Document",
diff --git a/app/config/specs/swagger2-1.7.x-client.json b/app/config/specs/swagger2-1.7.x-client.json
index 92132151b4..0e83cb4691 100644
--- a/app/config/specs/swagger2-1.7.x-client.json
+++ b/app/config/specs/swagger2-1.7.x-client.json
@@ -4809,7 +4809,7 @@
"tags": [
"databases"
],
- "description": "Create or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
"responses": {
"200": {
"description": "Document",
@@ -6729,7 +6729,8 @@
"png",
"webp",
"heic",
- "avif"
+ "avif",
+ "gif"
],
"x-enum-name": "ImageFormat",
"x-enum-keys": [],
diff --git a/app/config/specs/swagger2-1.7.x-console.json b/app/config/specs/swagger2-1.7.x-console.json
index e53a0dfb0b..9b2696efe5 100644
--- a/app/config/specs/swagger2-1.7.x-console.json
+++ b/app/config/specs/swagger2-1.7.x-console.json
@@ -8200,7 +8200,7 @@
"model": "#\/definitions\/documentList"
}
],
- "description": "Create new Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console."
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate new Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console."
}
],
"auth": {
@@ -8284,7 +8284,7 @@
"tags": [
"databases"
],
- "description": "Create or update Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.\n",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
"responses": {
"200": {
"description": "Documents List",
@@ -8372,7 +8372,7 @@
"tags": [
"databases"
],
- "description": "Update all documents that match your queries, if no queries are submitted then all documents are updated. You can pass only specific fields to be updated.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nUpdate all documents that match your queries, if no queries are submitted then all documents are updated. You can pass only specific fields to be updated.",
"responses": {
"200": {
"description": "Documents List",
@@ -8463,7 +8463,7 @@
"tags": [
"databases"
],
- "description": "Bulk delete documents using queries, if no queries are passed then all documents are deleted.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nBulk delete documents using queries, if no queries are passed then all documents are deleted.",
"responses": {
"200": {
"description": "Documents List",
@@ -8638,7 +8638,7 @@
"tags": [
"databases"
],
- "description": "Create or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
"responses": {
"200": {
"description": "Document",
@@ -9835,6 +9835,7 @@
"dart-3.1",
"dart-3.3",
"dart-3.5",
+ "dart-3.8",
"dotnet-6.0",
"dotnet-7.0",
"dotnet-8.0",
@@ -9860,7 +9861,8 @@
"static-1",
"flutter-3.24",
"flutter-3.27",
- "flutter-3.29"
+ "flutter-3.29",
+ "flutter-3.32"
],
"x-enum-name": null,
"x-enum-keys": []
@@ -10466,6 +10468,7 @@
"dart-3.1",
"dart-3.3",
"dart-3.5",
+ "dart-3.8",
"dotnet-6.0",
"dotnet-7.0",
"dotnet-8.0",
@@ -10491,7 +10494,8 @@
"static-1",
"flutter-3.24",
"flutter-3.27",
- "flutter-3.29"
+ "flutter-3.29",
+ "flutter-3.32"
],
"x-enum-name": null,
"x-enum-keys": []
@@ -25696,12 +25700,35 @@
"Temporary Redirect 307",
"Permanent Redirect 308"
]
+ },
+ "resourceId": {
+ "type": "string",
+ "description": "ID of parent resource.",
+ "default": null,
+ "x-example": ""
+ },
+ "resourceType": {
+ "type": "string",
+ "description": "Type of parent resource.",
+ "default": null,
+ "x-example": "site",
+ "enum": [
+ "site",
+ "function"
+ ],
+ "x-enum-name": "ProxyResourceType",
+ "x-enum-keys": [
+ "Site",
+ "Function"
+ ]
}
},
"required": [
"domain",
"url",
- "statusCode"
+ "statusCode",
+ "resourceId",
+ "resourceType"
]
}
}
@@ -26203,6 +26230,7 @@
"dart-3.1",
"dart-3.3",
"dart-3.5",
+ "dart-3.8",
"dotnet-6.0",
"dotnet-7.0",
"dotnet-8.0",
@@ -26228,7 +26256,8 @@
"static-1",
"flutter-3.24",
"flutter-3.27",
- "flutter-3.29"
+ "flutter-3.29",
+ "flutter-3.32"
],
"x-enum-name": null,
"x-enum-keys": []
@@ -26850,6 +26879,7 @@
"dart-3.1",
"dart-3.3",
"dart-3.5",
+ "dart-3.8",
"dotnet-6.0",
"dotnet-7.0",
"dotnet-8.0",
@@ -26875,7 +26905,8 @@
"static-1",
"flutter-3.24",
"flutter-3.27",
- "flutter-3.29"
+ "flutter-3.29",
+ "flutter-3.32"
],
"x-enum-name": null,
"x-enum-keys": []
@@ -29604,7 +29635,8 @@
"png",
"webp",
"heic",
- "avif"
+ "avif",
+ "gif"
],
"x-enum-name": "ImageFormat",
"x-enum-keys": [],
@@ -35063,6 +35095,15 @@
"x-example": "",
"default": "",
"in": "query"
+ },
+ {
+ "name": "providerReference",
+ "description": "Git reference (branch, tag, commit) to get contents from",
+ "required": false,
+ "type": "string",
+ "x-example": "",
+ "default": "",
+ "in": "query"
}
]
}
diff --git a/app/config/specs/swagger2-1.7.x-server.json b/app/config/specs/swagger2-1.7.x-server.json
index 083290bcc0..aba8aa5032 100644
--- a/app/config/specs/swagger2-1.7.x-server.json
+++ b/app/config/specs/swagger2-1.7.x-server.json
@@ -7671,7 +7671,7 @@
"model": "#\/definitions\/documentList"
}
],
- "description": "Create new Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console."
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate new Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console."
}
],
"auth": {
@@ -7757,7 +7757,7 @@
"tags": [
"databases"
],
- "description": "Create or update Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.\n",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
"responses": {
"200": {
"description": "Documents List",
@@ -7846,7 +7846,7 @@
"tags": [
"databases"
],
- "description": "Update all documents that match your queries, if no queries are submitted then all documents are updated. You can pass only specific fields to be updated.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nUpdate all documents that match your queries, if no queries are submitted then all documents are updated. You can pass only specific fields to be updated.",
"responses": {
"200": {
"description": "Documents List",
@@ -7938,7 +7938,7 @@
"tags": [
"databases"
],
- "description": "Bulk delete documents using queries, if no queries are passed then all documents are deleted.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nBulk delete documents using queries, if no queries are passed then all documents are deleted.",
"responses": {
"200": {
"description": "Documents List",
@@ -8116,7 +8116,7 @@
"tags": [
"databases"
],
- "description": "Create or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
"responses": {
"200": {
"description": "Document",
@@ -8927,6 +8927,7 @@
"dart-3.1",
"dart-3.3",
"dart-3.5",
+ "dart-3.8",
"dotnet-6.0",
"dotnet-7.0",
"dotnet-8.0",
@@ -8952,7 +8953,8 @@
"static-1",
"flutter-3.24",
"flutter-3.27",
- "flutter-3.29"
+ "flutter-3.29",
+ "flutter-3.32"
],
"x-enum-name": null,
"x-enum-keys": []
@@ -9340,6 +9342,7 @@
"dart-3.1",
"dart-3.3",
"dart-3.5",
+ "dart-3.8",
"dotnet-6.0",
"dotnet-7.0",
"dotnet-8.0",
@@ -9365,7 +9368,8 @@
"static-1",
"flutter-3.24",
"flutter-3.27",
- "flutter-3.29"
+ "flutter-3.29",
+ "flutter-3.32"
],
"x-enum-name": null,
"x-enum-keys": []
@@ -17792,6 +17796,7 @@
"dart-3.1",
"dart-3.3",
"dart-3.5",
+ "dart-3.8",
"dotnet-6.0",
"dotnet-7.0",
"dotnet-8.0",
@@ -17817,7 +17822,8 @@
"static-1",
"flutter-3.24",
"flutter-3.27",
- "flutter-3.29"
+ "flutter-3.29",
+ "flutter-3.32"
],
"x-enum-name": null,
"x-enum-keys": []
@@ -18221,6 +18227,7 @@
"dart-3.1",
"dart-3.3",
"dart-3.5",
+ "dart-3.8",
"dotnet-6.0",
"dotnet-7.0",
"dotnet-8.0",
@@ -18246,7 +18253,8 @@
"static-1",
"flutter-3.24",
"flutter-3.27",
- "flutter-3.29"
+ "flutter-3.29",
+ "flutter-3.32"
],
"x-enum-name": null,
"x-enum-keys": []
@@ -20935,7 +20943,8 @@
"png",
"webp",
"heic",
- "avif"
+ "avif",
+ "gif"
],
"x-enum-name": "ImageFormat",
"x-enum-keys": [],
diff --git a/app/config/specs/swagger2-latest-client.json b/app/config/specs/swagger2-latest-client.json
index e369e2f0f3..804136b303 100644
--- a/app/config/specs/swagger2-latest-client.json
+++ b/app/config/specs/swagger2-latest-client.json
@@ -3451,7 +3451,6 @@
"scope": "avatars.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -3576,7 +3575,6 @@
"scope": "avatars.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -3707,7 +3705,6 @@
"scope": "avatars.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -3770,7 +3767,6 @@
"scope": "avatars.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -4257,7 +4253,6 @@
"scope": "avatars.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -4340,7 +4335,6 @@
"scope": "avatars.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -4431,7 +4425,6 @@
"scope": "avatars.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -4522,7 +4515,6 @@
"scope": "documents.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -4605,7 +4597,6 @@
"platforms": [
"console",
"client",
- "server",
"server"
],
"packaging": false,
@@ -4638,29 +4629,6 @@
}
],
"description": "Create a new Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console."
- },
- {
- "name": "createDocuments",
- "auth": {
- "Key": []
- },
- "parameters": [
- "databaseId",
- "collectionId",
- "documents"
- ],
- "required": [
- "databaseId",
- "collectionId",
- "documents"
- ],
- "responses": [
- {
- "code": 201,
- "model": "#\/definitions\/documentList"
- }
- ],
- "description": "Create new Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console."
}
],
"auth": {
@@ -4768,7 +4736,6 @@
"scope": "documents.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -4834,7 +4801,7 @@
"tags": [
"databases"
],
- "description": "Create or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
"responses": {
"200": {
"description": "Document",
@@ -4858,7 +4825,6 @@
"scope": "documents.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -4963,7 +4929,6 @@
"scope": "documents.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -5060,7 +5025,6 @@
"scope": "documents.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -5356,7 +5320,6 @@
"scope": "execution.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -5430,7 +5393,6 @@
"scope": "execution.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -5547,7 +5509,6 @@
"scope": "execution.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -5619,8 +5580,7 @@
"scope": "graphql",
"platforms": [
"server",
- "client",
- "server"
+ "client"
],
"packaging": false,
"auth": {
@@ -5693,8 +5653,7 @@
"scope": "graphql",
"platforms": [
"server",
- "client",
- "server"
+ "client"
],
"packaging": false,
"auth": {
@@ -5765,7 +5724,6 @@
"scope": "locale.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -5817,7 +5775,6 @@
"scope": "locale.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -5869,7 +5826,6 @@
"scope": "locale.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -5921,7 +5877,6 @@
"scope": "locale.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -5973,7 +5928,6 @@
"scope": "locale.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -6025,7 +5979,6 @@
"scope": "locale.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -6077,7 +6030,6 @@
"scope": "locale.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -6129,7 +6081,6 @@
"scope": "locale.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -6184,8 +6135,7 @@
"platforms": [
"server",
"client",
- "console",
- "server"
+ "console"
],
"packaging": false,
"auth": {
@@ -6269,8 +6219,7 @@
"platforms": [
"server",
"client",
- "console",
- "server"
+ "console"
],
"packaging": false,
"auth": {
@@ -6339,7 +6288,6 @@
"scope": "files.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -6422,7 +6370,6 @@
"scope": "files.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -6512,7 +6459,6 @@
"scope": "files.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -6582,7 +6528,6 @@
"scope": "files.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -6671,7 +6616,6 @@
"scope": "files.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -6741,7 +6685,6 @@
"scope": "files.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -6820,7 +6763,6 @@
"scope": "files.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -7027,7 +6969,6 @@
"scope": "files.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -7106,7 +7047,6 @@
"scope": "teams.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -7181,7 +7121,6 @@
"scope": "teams.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -7271,7 +7210,6 @@
"scope": "teams.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -7333,7 +7271,6 @@
"scope": "teams.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -7408,7 +7345,6 @@
"scope": "teams.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -7470,7 +7406,6 @@
"scope": "teams.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -7553,7 +7488,6 @@
"scope": "teams.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -7666,7 +7600,6 @@
"scope": "teams.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -7736,7 +7669,6 @@
"scope": "teams.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -7822,7 +7754,6 @@
"scope": "teams.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
diff --git a/app/config/specs/swagger2-latest-console.json b/app/config/specs/swagger2-latest-console.json
index da959a8180..461337ebda 100644
--- a/app/config/specs/swagger2-latest-console.json
+++ b/app/config/specs/swagger2-latest-console.json
@@ -3466,7 +3466,6 @@
"scope": "avatars.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -3591,7 +3590,6 @@
"scope": "avatars.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -3722,7 +3720,6 @@
"scope": "avatars.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -3785,7 +3782,6 @@
"scope": "avatars.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -4272,7 +4268,6 @@
"scope": "avatars.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -4355,7 +4350,6 @@
"scope": "avatars.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -4446,7 +4440,6 @@
"scope": "avatars.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -8064,7 +8057,6 @@
"scope": "documents.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -8147,7 +8139,6 @@
"platforms": [
"console",
"client",
- "server",
"server"
],
"packaging": false,
@@ -8203,7 +8194,7 @@
"model": "#\/definitions\/documentList"
}
],
- "description": "Create new Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console."
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate new Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console."
}
],
"auth": {
@@ -8287,7 +8278,7 @@
"tags": [
"databases"
],
- "description": "Create or update Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.\n",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
"responses": {
"200": {
"description": "Documents List",
@@ -8376,7 +8367,7 @@
"tags": [
"databases"
],
- "description": "Update all documents that match your queries, if no queries are submitted then all documents are updated. You can pass only specific fields to be updated.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nUpdate all documents that match your queries, if no queries are submitted then all documents are updated. You can pass only specific fields to be updated.",
"responses": {
"200": {
"description": "Documents List",
@@ -8468,7 +8459,7 @@
"tags": [
"databases"
],
- "description": "Bulk delete documents using queries, if no queries are passed then all documents are deleted.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nBulk delete documents using queries, if no queries are passed then all documents are deleted.",
"responses": {
"200": {
"description": "Documents List",
@@ -8578,7 +8569,6 @@
"scope": "documents.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -8644,7 +8634,7 @@
"tags": [
"databases"
],
- "description": "Create or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
"responses": {
"200": {
"description": "Document",
@@ -8668,7 +8658,6 @@
"scope": "documents.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -8773,7 +8762,6 @@
"scope": "documents.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -8870,7 +8858,6 @@
"scope": "documents.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -11588,7 +11575,6 @@
"rate-key": "url:{url},ip:{ip}",
"scope": "functions.read",
"platforms": [
- "server",
"server"
],
"packaging": false,
@@ -11742,7 +11728,6 @@
"scope": "execution.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -11816,7 +11801,6 @@
"scope": "execution.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -11933,7 +11917,6 @@
"scope": "execution.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -12520,8 +12503,7 @@
"scope": "graphql",
"platforms": [
"server",
- "client",
- "server"
+ "client"
],
"packaging": false,
"auth": {
@@ -12594,8 +12576,7 @@
"scope": "graphql",
"platforms": [
"server",
- "client",
- "server"
+ "client"
],
"packaging": false,
"auth": {
@@ -13929,7 +13910,6 @@
"scope": "locale.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -13981,7 +13961,6 @@
"scope": "locale.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -14033,7 +14012,6 @@
"scope": "locale.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -14085,7 +14063,6 @@
"scope": "locale.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -14137,7 +14114,6 @@
"scope": "locale.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -14189,7 +14165,6 @@
"scope": "locale.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -14241,7 +14216,6 @@
"scope": "locale.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -14293,7 +14267,6 @@
"scope": "locale.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -18682,8 +18655,7 @@
"platforms": [
"server",
"client",
- "console",
- "server"
+ "console"
],
"packaging": false,
"auth": {
@@ -18833,8 +18805,7 @@
"platforms": [
"server",
"client",
- "console",
- "server"
+ "console"
],
"packaging": false,
"auth": {
@@ -27957,7 +27928,6 @@
"rate-key": "url:{url},ip:{ip}",
"scope": "sites.read",
"platforms": [
- "server",
"server"
],
"packaging": false,
@@ -29226,7 +29196,6 @@
"scope": "files.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -29309,7 +29278,6 @@
"scope": "files.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -29399,7 +29367,6 @@
"scope": "files.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -29469,7 +29436,6 @@
"scope": "files.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -29558,7 +29524,6 @@
"scope": "files.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -29628,7 +29593,6 @@
"scope": "files.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -29707,7 +29671,6 @@
"scope": "files.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -29914,7 +29877,6 @@
"scope": "files.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -30141,7 +30103,6 @@
"scope": "teams.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -30216,7 +30177,6 @@
"scope": "teams.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -30306,7 +30266,6 @@
"scope": "teams.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -30368,7 +30327,6 @@
"scope": "teams.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -30443,7 +30401,6 @@
"scope": "teams.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -30575,7 +30532,6 @@
"scope": "teams.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -30658,7 +30614,6 @@
"scope": "teams.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -30771,7 +30726,6 @@
"scope": "teams.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -30841,7 +30795,6 @@
"scope": "teams.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -30927,7 +30880,6 @@
"scope": "teams.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
diff --git a/app/config/specs/swagger2-latest-server.json b/app/config/specs/swagger2-latest-server.json
index 7c15f9e5ea..4515d98fb5 100644
--- a/app/config/specs/swagger2-latest-server.json
+++ b/app/config/specs/swagger2-latest-server.json
@@ -3142,7 +3142,6 @@
"scope": "avatars.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -3269,7 +3268,6 @@
"scope": "avatars.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -3402,7 +3400,6 @@
"scope": "avatars.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -3467,7 +3464,6 @@
"scope": "avatars.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -3956,7 +3952,6 @@
"scope": "avatars.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -4041,7 +4036,6 @@
"scope": "avatars.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -4134,7 +4128,6 @@
"scope": "avatars.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -7533,7 +7526,6 @@
"scope": "documents.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -7618,7 +7610,6 @@
"platforms": [
"console",
"client",
- "server",
"server"
],
"packaging": false,
@@ -7674,7 +7665,7 @@
"model": "#\/definitions\/documentList"
}
],
- "description": "Create new Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console."
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate new Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console."
}
],
"auth": {
@@ -7760,7 +7751,7 @@
"tags": [
"databases"
],
- "description": "Create or update Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.\n",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
"responses": {
"200": {
"description": "Documents List",
@@ -7850,7 +7841,7 @@
"tags": [
"databases"
],
- "description": "Update all documents that match your queries, if no queries are submitted then all documents are updated. You can pass only specific fields to be updated.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nUpdate all documents that match your queries, if no queries are submitted then all documents are updated. You can pass only specific fields to be updated.",
"responses": {
"200": {
"description": "Documents List",
@@ -7943,7 +7934,7 @@
"tags": [
"databases"
],
- "description": "Bulk delete documents using queries, if no queries are passed then all documents are deleted.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nBulk delete documents using queries, if no queries are passed then all documents are deleted.",
"responses": {
"200": {
"description": "Documents List",
@@ -8054,7 +8045,6 @@
"scope": "documents.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -8122,7 +8112,7 @@
"tags": [
"databases"
],
- "description": "Create or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
+ "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
"responses": {
"200": {
"description": "Document",
@@ -8146,7 +8136,6 @@
"scope": "documents.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -8253,7 +8242,6 @@
"scope": "documents.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -8352,7 +8340,6 @@
"scope": "documents.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -10475,7 +10462,6 @@
"rate-key": "url:{url},ip:{ip}",
"scope": "functions.read",
"platforms": [
- "server",
"server"
],
"packaging": false,
@@ -10631,7 +10617,6 @@
"scope": "execution.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -10707,7 +10692,6 @@
"scope": "execution.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -10826,7 +10810,6 @@
"scope": "execution.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -11343,8 +11326,7 @@
"scope": "graphql",
"platforms": [
"server",
- "client",
- "server"
+ "client"
],
"packaging": false,
"auth": {
@@ -11419,8 +11401,7 @@
"scope": "graphql",
"platforms": [
"server",
- "client",
- "server"
+ "client"
],
"packaging": false,
"auth": {
@@ -12778,7 +12759,6 @@
"scope": "locale.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -12832,7 +12812,6 @@
"scope": "locale.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -12886,7 +12865,6 @@
"scope": "locale.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -12940,7 +12918,6 @@
"scope": "locale.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -12994,7 +12971,6 @@
"scope": "locale.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -13048,7 +13024,6 @@
"scope": "locale.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -13102,7 +13077,6 @@
"scope": "locale.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -13156,7 +13130,6 @@
"scope": "locale.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -17590,8 +17563,7 @@
"platforms": [
"server",
"client",
- "console",
- "server"
+ "console"
],
"packaging": false,
"auth": {
@@ -17744,8 +17716,7 @@
"platforms": [
"server",
"client",
- "console",
- "server"
+ "console"
],
"packaging": false,
"auth": {
@@ -19318,7 +19289,6 @@
"rate-key": "url:{url},ip:{ip}",
"scope": "sites.read",
"platforms": [
- "server",
"server"
],
"packaging": false,
@@ -20524,7 +20494,6 @@
"scope": "files.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -20609,7 +20578,6 @@
"scope": "files.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -20701,7 +20669,6 @@
"scope": "files.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -20773,7 +20740,6 @@
"scope": "files.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -20864,7 +20830,6 @@
"scope": "files.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -20936,7 +20901,6 @@
"scope": "files.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -21017,7 +20981,6 @@
"scope": "files.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -21226,7 +21189,6 @@
"scope": "files.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -21307,7 +21269,6 @@
"scope": "teams.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -21384,7 +21345,6 @@
"scope": "teams.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -21476,7 +21436,6 @@
"scope": "teams.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -21540,7 +21499,6 @@
"scope": "teams.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -21617,7 +21575,6 @@
"scope": "teams.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -21681,7 +21638,6 @@
"scope": "teams.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -21766,7 +21722,6 @@
"scope": "teams.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -21881,7 +21836,6 @@
"scope": "teams.read",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -21953,7 +21907,6 @@
"scope": "teams.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
@@ -22041,7 +21994,6 @@
"scope": "teams.write",
"platforms": [
"client",
- "server",
"server"
],
"packaging": false,
diff --git a/app/config/templates/function.php b/app/config/templates/function.php
index d8426ad900..9a905c83b1 100644
--- a/app/config/templates/function.php
+++ b/app/config/templates/function.php
@@ -635,7 +635,7 @@ return [
'type' => 'url'
]
],
- 'scopes' => ['databases.read', 'databases.write', 'collections.write', 'attributes.write', 'documents.read', 'documents.write']
+ 'scopes' => ['databases.read', 'databases.write', 'collections.write', 'tables.write', 'attributes.write', 'columns.write', 'documents.read', 'rows.read', 'documents.write', 'rows.write']
],
[
'icon' => 'icon-algolia',
@@ -717,7 +717,7 @@ return [
'type' => 'password'
],
],
- 'scopes' => ['databases.read', 'collections.read', 'documents.read']
+ 'scopes' => ['databases.read', 'collections.read', 'tables.read', 'documents.read', 'rows.read']
],
[
'icon' => 'icon-meilisearch',
@@ -811,7 +811,7 @@ return [
'type' => 'text'
],
],
- 'scopes' => ['databases.read', 'collections.read', 'documents.read']
+ 'scopes' => ['databases.read', 'collections.read', 'tables.read', 'documents.read', 'rows.read']
],
[
'icon' => 'icon-vonage',
@@ -1139,7 +1139,7 @@ return [
'type' => 'text'
]
],
- 'scopes' => ['databases.read', 'databases.write', 'collections.write', 'attributes.write', 'documents.read', 'documents.write']
+ 'scopes' => ['databases.read', 'databases.write', 'collections.write', 'tables.write', 'attributes.write', 'columns.write', 'documents.read', 'rows.read', 'documents.write', 'rows.write']
],
[
'icon' => 'icon-chat',
@@ -1268,7 +1268,7 @@ return [
'type' => 'password'
]
],
- 'scopes' => ['databases.read', 'databases.write', 'collections.read', 'collections.write', 'attributes.write', 'documents.read', 'documents.write', 'buckets.read', 'buckets.write', 'files.read']
+ 'scopes' => ['databases.read', 'databases.write', 'collections.read', 'tables.read', 'collections.write', 'tables.write', 'attributes.write', 'columns.write', 'documents.read', 'rows.read', 'documents.write', 'rows.write', 'buckets.read', 'buckets.write', 'files.read']
],
[
'icon' => 'icon-eye',
@@ -1327,7 +1327,7 @@ return [
'type' => 'password'
]
],
- 'scopes' => ['databases.read', 'databases.write', 'collections.read', 'collections.write', 'attributes.write', 'documents.read', 'documents.write', 'buckets.read', 'buckets.write', 'files.read']
+ 'scopes' => ['databases.read', 'databases.write', 'collections.read', 'tables.read', 'collections.write', 'tables.write', 'attributes.write', 'columns.write', 'documents.read', 'rows.read', 'documents.write', 'rows.write', 'buckets.read', 'buckets.write', 'files.read']
],
[
'icon' => 'icon-text',
@@ -1386,7 +1386,7 @@ return [
'type' => 'password'
]
],
- 'scopes' => ['databases.read', 'databases.write', 'collections.read', 'collections.write', 'attributes.write', 'documents.read', 'documents.write', 'buckets.read', 'buckets.write', 'files.read']
+ 'scopes' => ['databases.read', 'databases.write', 'collections.read', 'tables.read', 'collections.write', 'tables.write', 'attributes.write', 'columns.write', 'documents.read', 'rows.read', 'documents.write', 'rows.write', 'buckets.read', 'buckets.write', 'files.read']
],
[
'icon' => 'icon-chat',
@@ -1395,7 +1395,10 @@ return [
'score' => 5,
'tagline' => 'Convert text to speech using the Hugging Face inference API.',
'permissions' => ['any'],
- 'events' => ['databases.*.collections.*.documents.*.create'],
+ 'events' => [
+ 'databases.*.tables.*.rows.*.create',
+ 'databases.*.collections.*.documents.*.create',
+ ],
'cron' => '',
'timeout' => 15,
'useCases' => ['ai'],
@@ -1666,7 +1669,7 @@ return [
'type' => 'text'
]
],
- 'scopes' => ['databases.read', 'collections.read', 'documents.read']
+ 'scopes' => ['databases.read', 'collections.read', 'tables.read', 'documents.read', 'rows.read']
],
[
'icon' => 'icon-chip',
@@ -1730,7 +1733,7 @@ return [
'type' => 'text'
]
],
- 'scopes' => ['databases.read', 'collections.read', 'documents.read']
+ 'scopes' => ['databases.read', 'collections.read', 'tables.read', 'documents.read', 'rows.read']
],
[
'icon' => 'icon-chat',
diff --git a/app/config/templates/site.php b/app/config/templates/site.php
index a853955a97..4ae6f61607 100644
--- a/app/config/templates/site.php
+++ b/app/config/templates/site.php
@@ -6,13 +6,8 @@ use Utopia\System\System;
* List of Appwrite Sites templates
*/
-$protocol = System::getEnv('_APP_OPTIONS_FORCE_HTTPS') == 'disabled' ? 'http' : 'https';
-$hostname = System::getEnv('_APP_DOMAIN');
-
-// TODO: Development override
-if (System::getEnv('_APP_ENV') === 'development') {
- $hostname = 'localhost';
-}
+$protocol = System::getEnv('_APP_OPTIONS_FORCE_HTTPS') === 'disabled' ? 'http' : 'https';
+$hostname = System::getEnv('_APP_DOMAIN', '');
$url = $protocol . '://' . $hostname;
diff --git a/app/controllers/api/account.php b/app/controllers/api/account.php
index 2bb009cf61..2abc4f03e1 100644
--- a/app/controllers/api/account.php
+++ b/app/controllers/api/account.php
@@ -21,6 +21,7 @@ use Appwrite\Event\StatsUsage;
use Appwrite\Extend\Exception;
use Appwrite\Hooks\Hooks;
use Appwrite\Network\Validator\Email;
+use Appwrite\Network\Validator\Redirect;
use Appwrite\OpenSSL\OpenSSL;
use Appwrite\SDK\AuthType;
use Appwrite\SDK\ContentType;
@@ -60,7 +61,6 @@ use Utopia\System\System;
use Utopia\Validator\ArrayList;
use Utopia\Validator\Assoc;
use Utopia\Validator\Boolean;
-use Utopia\Validator\Host;
use Utopia\Validator\Text;
use Utopia\Validator\URL;
use Utopia\Validator\WhiteList;
@@ -1182,8 +1182,8 @@ App::get('/v1/account/sessions/oauth2/:provider')
->label('abuse-limit', 50)
->label('abuse-key', 'ip:{ip}')
->param('provider', '', new WhiteList(\array_keys(Config::getParam('oAuthProviders')), true), 'OAuth2 Provider. Currently, supported providers are: ' . \implode(', ', \array_keys(\array_filter(Config::getParam('oAuthProviders'), fn ($node) => (!$node['mock'])))) . '.')
- ->param('success', '', fn ($clients, $devKey) => $devKey->isEmpty() ? new Host($clients) : new URL(), 'URL to redirect back to your app after a successful login attempt. Only URLs from hostnames in your project\'s platform list are allowed. This requirement helps to prevent an [open redirect](https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html) attack against your project API.', true, ['clients', 'devKey'])
- ->param('failure', '', fn ($clients, $devKey) => $devKey->isEmpty() ? new Host($clients) : new URL(), 'URL to redirect back to your app after a failed login attempt. Only URLs from hostnames in your project\'s platform list are allowed. This requirement helps to prevent an [open redirect](https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html) attack against your project API.', true, ['clients', 'devKey'])
+ ->param('success', '', fn ($platforms, $devKey) => $devKey->isEmpty() ? new Redirect($platforms) : new URL(), 'URL to redirect back to your app after a successful login attempt. Only URLs from hostnames in your project\'s platform list are allowed. This requirement helps to prevent an [open redirect](https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html) attack against your project API.', true, ['platforms', 'devKey'])
+ ->param('failure', '', fn ($platforms, $devKey) => $devKey->isEmpty() ? new Redirect($platforms) : new URL(), 'URL to redirect back to your app after a failed login attempt. Only URLs from hostnames in your project\'s platform list are allowed. This requirement helps to prevent an [open redirect](https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html) attack against your project API.', true, ['platforms', 'devKey'])
->param('scopes', [], new ArrayList(new Text(APP_LIMIT_ARRAY_ELEMENT_SIZE), APP_LIMIT_ARRAY_PARAMS_SIZE), 'A list of custom OAuth2 scopes. Check each provider internal docs for a list of supported scopes. Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' scopes are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long.', true)
->inject('request')
->inject('response')
@@ -1282,7 +1282,6 @@ App::post('/v1/account/sessions/oauth2/callback/:provider/:projectId')
->inject('request')
->inject('response')
->action(function (string $projectId, string $provider, string $code, string $state, string $error, string $error_description, Request $request, Response $response) {
-
$domain = $request->getHostname();
$protocol = $request->getProtocol();
@@ -1779,8 +1778,8 @@ App::get('/v1/account/tokens/oauth2/:provider')
->label('abuse-limit', 50)
->label('abuse-key', 'ip:{ip}')
->param('provider', '', new WhiteList(\array_keys(Config::getParam('oAuthProviders')), true), 'OAuth2 Provider. Currently, supported providers are: ' . \implode(', ', \array_keys(\array_filter(Config::getParam('oAuthProviders'), fn ($node) => (!$node['mock'])))) . '.')
- ->param('success', '', fn ($clients, $devKey) => $devKey->isEmpty() ? new Host($clients) : new URL(), 'URL to redirect back to your app after a successful login attempt. Only URLs from hostnames in your project\'s platform list are allowed. This requirement helps to prevent an [open redirect](https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html) attack against your project API.', true, ['clients', 'devKey'])
- ->param('failure', '', fn ($clients, $devKey) => $devKey->isEmpty() ? new Host($clients) : new URL(), 'URL to redirect back to your app after a failed login attempt. Only URLs from hostnames in your project\'s platform list are allowed. This requirement helps to prevent an [open redirect](https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html) attack against your project API.', true, ['clients', 'devKey'])
+ ->param('success', '', fn ($platforms, $devKey) => $devKey->isEmpty() ? new Redirect($platforms) : new URL(), 'URL to redirect back to your app after a successful login attempt. Only URLs from hostnames in your project\'s platform list are allowed. This requirement helps to prevent an [open redirect](https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html) attack against your project API.', true, ['platforms', 'devKey'])
+ ->param('failure', '', fn ($platforms, $devKey) => $devKey->isEmpty() ? new Redirect($platforms) : new URL(), 'URL to redirect back to your app after a failed login attempt. Only URLs from hostnames in your project\'s platform list are allowed. This requirement helps to prevent an [open redirect](https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html) attack against your project API.', true, ['platforms', 'devKey'])
->param('scopes', [], new ArrayList(new Text(APP_LIMIT_ARRAY_ELEMENT_SIZE), APP_LIMIT_ARRAY_PARAMS_SIZE), 'A list of custom OAuth2 scopes. Check each provider internal docs for a list of supported scopes. Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' scopes are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long.', true)
->inject('request')
->inject('response')
@@ -1860,7 +1859,7 @@ App::post('/v1/account/tokens/magic-url')
->label('abuse-key', ['url:{url},email:{param-email}', 'url:{url},ip:{ip}'])
->param('userId', '', new CustomId(), 'Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can\'t start with a special char. Max length is 36 chars.')
->param('email', '', new Email(), 'User email.')
- ->param('url', '', fn ($clients, $devKey) => $devKey->isEmpty() ? new Host($clients) : new URL(), 'URL to redirect the user back to your app from the magic URL login. Only URLs from hostnames in your project platform list are allowed. This requirement helps to prevent an [open redirect](https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html) attack against your project API.', true, ['clients', 'devKey'])
+ ->param('url', '', fn ($platforms, $devKey) => $devKey->isEmpty() ? new Redirect($platforms) : new URL(), 'URL to redirect the user back to your app from the magic URL login. Only URLs from hostnames in your project platform list are allowed. This requirement helps to prevent an [open redirect](https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html) attack against your project API.', true, ['platforms', 'devKey'])
->param('phrase', false, new Boolean(), 'Toggle for security phrase. If enabled, email will be send with a randomly generated phrase and the phrase will also be included in the response. Confirming phrases match increases the security of your authentication flow.', true)
->inject('request')
->inject('response')
@@ -3158,7 +3157,7 @@ App::post('/v1/account/recovery')
->label('abuse-limit', 10)
->label('abuse-key', ['url:{url},email:{param-email}', 'url:{url},ip:{ip}'])
->param('email', '', new Email(), 'User email.')
- ->param('url', '', fn ($clients, $devKey) => $devKey->isEmpty() ? new Host($clients) : new URL(), 'URL to redirect the user back to your app from the recovery email. Only URLs from hostnames in your project platform list are allowed. This requirement helps to prevent an [open redirect](https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html) attack against your project API.', false, ['clients', 'devKey'])
+ ->param('url', '', fn ($platforms, $devKey) => $devKey->isEmpty() ? new Redirect($platforms) : new URL(), 'URL to redirect the user back to your app from the recovery email. Only URLs from hostnames in your project platform list are allowed. This requirement helps to prevent an [open redirect](https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html) attack against your project API.', false, ['platforms', 'devKey'])
->inject('request')
->inject('response')
->inject('user')
@@ -3229,6 +3228,7 @@ App::post('/v1/account/recovery')
->setParam('{{hello}}', $locale->getText("emails.recovery.hello"))
->setParam('{{footer}}', $locale->getText("emails.recovery.footer"))
->setParam('{{thanks}}', $locale->getText("emails.recovery.thanks"))
+ ->setParam('{{buttonText}}', $locale->getText("emails.recovery.buttonText"))
->setParam('{{signature}}', $locale->getText("emails.recovery.signature"));
$body = $message->render();
@@ -3424,7 +3424,7 @@ App::post('/v1/account/verification')
))
->label('abuse-limit', 10)
->label('abuse-key', 'url:{url},userId:{userId}')
- ->param('url', '', fn ($clients, $devKey) => $devKey->isEmpty() ? new Host($clients) : new URL(), 'URL to redirect the user back to your app from the verification email. Only URLs from hostnames in your project platform list are allowed. This requirement helps to prevent an [open redirect](https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html) attack against your project API.', false, ['clients', 'devKey']) // TODO add built-in confirm page
+ ->param('url', '', fn ($platforms, $devKey) => $devKey->isEmpty() ? new Redirect($platforms) : new URL(), 'URL to redirect the user back to your app from the verification email. Only URLs from hostnames in your project platform list are allowed. This requirement helps to prevent an [open redirect](https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html) attack against your project API.', false, ['platforms', 'devKey']) // TODO add built-in confirm page
->inject('request')
->inject('response')
->inject('project')
@@ -3484,6 +3484,7 @@ App::post('/v1/account/verification')
->setParam('{{hello}}', $locale->getText("emails.verification.hello"))
->setParam('{{footer}}', $locale->getText("emails.verification.footer"))
->setParam('{{thanks}}', $locale->getText("emails.verification.thanks"))
+ ->setParam('{{buttonText}}', $locale->getText("emails.verification.buttonText"))
->setParam('{{signature}}', $locale->getText("emails.verification.signature"));
$body = $message->render();
diff --git a/app/controllers/api/databases.php b/app/controllers/api/databases.php
deleted file mode 100644
index 31ab002df2..0000000000
--- a/app/controllers/api/databases.php
+++ /dev/null
@@ -1,5352 +0,0 @@
-getAttribute('key');
- $type = $attribute->getAttribute('type', '');
- $size = $attribute->getAttribute('size', 0);
- $required = $attribute->getAttribute('required', true);
- $signed = $attribute->getAttribute('signed', true); // integers are signed by default
- $array = $attribute->getAttribute('array', false);
- $format = $attribute->getAttribute('format', '');
- $formatOptions = $attribute->getAttribute('formatOptions', []);
- $filters = $attribute->getAttribute('filters', []); // filters are hidden from the endpoint
- $default = $attribute->getAttribute('default');
- $options = $attribute->getAttribute('options', []);
-
- $database = $dbForProject->getDocument('databases', $databaseId);
-
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
-
- if ($collection->isEmpty()) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- if (!empty($format)) {
- if (!Structure::hasFormat($format, $type)) {
- throw new Exception(Exception::ATTRIBUTE_FORMAT_UNSUPPORTED, "Format {$format} not available for {$type} attributes.");
- }
- }
-
- // Must throw here since dbForProject->createAttribute is performed by db worker
- if ($required && isset($default)) {
- throw new Exception(Exception::ATTRIBUTE_DEFAULT_UNSUPPORTED, 'Cannot set default value for required attribute');
- }
-
- if ($array && isset($default)) {
- throw new Exception(Exception::ATTRIBUTE_DEFAULT_UNSUPPORTED, 'Cannot set default value for array attributes');
- }
-
- if ($type === Database::VAR_RELATIONSHIP) {
- $options['side'] = Database::RELATION_SIDE_PARENT;
- $relatedCollection = $dbForProject->getDocument('database_' . $database->getSequence(), $options['relatedCollection'] ?? '');
- if ($relatedCollection->isEmpty()) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND, 'The related collection was not found.');
- }
- }
-
- try {
- $attribute = new Document([
- '$id' => ID::custom($database->getSequence() . '_' . $collection->getSequence() . '_' . $key),
- 'key' => $key,
- 'databaseInternalId' => $database->getSequence(),
- 'databaseId' => $database->getId(),
- 'collectionInternalId' => $collection->getSequence(),
- 'collectionId' => $collectionId,
- 'type' => $type,
- 'status' => 'processing', // processing, available, failed, deleting, stuck
- 'size' => $size,
- 'required' => $required,
- 'signed' => $signed,
- 'default' => $default,
- 'array' => $array,
- 'format' => $format,
- 'formatOptions' => $formatOptions,
- 'filters' => $filters,
- 'options' => $options,
- ]);
-
- $dbForProject->checkAttribute($collection, $attribute);
- $attribute = $dbForProject->createDocument('attributes', $attribute);
- } catch (DuplicateException) {
- throw new Exception(Exception::ATTRIBUTE_ALREADY_EXISTS);
- } catch (LimitException) {
- throw new Exception(Exception::ATTRIBUTE_LIMIT_EXCEEDED);
- } catch (\Throwable $e) {
- $dbForProject->purgeCachedDocument('database_' . $database->getSequence(), $collectionId);
- $dbForProject->purgeCachedCollection('database_' . $database->getSequence() . '_collection_' . $collection->getSequence());
- throw $e;
- }
-
- $dbForProject->purgeCachedDocument('database_' . $database->getSequence(), $collectionId);
- $dbForProject->purgeCachedCollection('database_' . $database->getSequence() . '_collection_' . $collection->getSequence());
-
- if ($type === Database::VAR_RELATIONSHIP && $options['twoWay']) {
- $twoWayKey = $options['twoWayKey'];
- $options['relatedCollection'] = $collection->getId();
- $options['twoWayKey'] = $key;
- $options['side'] = Database::RELATION_SIDE_CHILD;
-
- try {
- try {
- $twoWayAttribute = new Document([
- '$id' => ID::custom($database->getSequence() . '_' . $relatedCollection->getSequence() . '_' . $twoWayKey),
- 'key' => $twoWayKey,
- 'databaseInternalId' => $database->getSequence(),
- 'databaseId' => $database->getId(),
- 'collectionInternalId' => $relatedCollection->getSequence(),
- 'collectionId' => $relatedCollection->getId(),
- 'type' => $type,
- 'status' => 'processing', // processing, available, failed, deleting, stuck
- 'size' => $size,
- 'required' => $required,
- 'signed' => $signed,
- 'default' => $default,
- 'array' => $array,
- 'format' => $format,
- 'formatOptions' => $formatOptions,
- 'filters' => $filters,
- 'options' => $options,
- ]);
-
- $dbForProject->checkAttribute($relatedCollection, $twoWayAttribute);
- $dbForProject->createDocument('attributes', $twoWayAttribute);
- } catch (DuplicateException) {
- throw new Exception(Exception::DOCUMENT_ALREADY_EXISTS);
- } catch (LimitException) {
- throw new Exception(Exception::ATTRIBUTE_LIMIT_EXCEEDED);
- } catch (StructureException $e) {
- throw new Exception(Exception::DOCUMENT_INVALID_STRUCTURE, $e->getMessage());
- }
- } catch (\Throwable $e) {
- $dbForProject->deleteDocument('attributes', $attribute->getId());
- throw $e;
- } finally {
- $dbForProject->purgeCachedDocument('database_' . $database->getSequence(), $collectionId);
- $dbForProject->purgeCachedCollection('database_' . $database->getSequence() . '_collection_' . $collection->getSequence());
- }
-
- // If operation succeeded, purge the cache for the related collection too
- $dbForProject->purgeCachedDocument('database_' . $database->getSequence(), $relatedCollection->getId());
- $dbForProject->purgeCachedCollection('database_' . $database->getSequence() . '_collection_' . $relatedCollection->getSequence());
- }
-
- $queueForDatabase
- ->setType(DATABASE_TYPE_CREATE_ATTRIBUTE)
- ->setDatabase($database)
- ->setCollection($collection)
- ->setDocument($attribute);
-
- $queueForEvents
- ->setContext('collection', $collection)
- ->setContext('database', $database)
- ->setParam('databaseId', $databaseId)
- ->setParam('collectionId', $collection->getId())
- ->setParam('attributeId', $attribute->getId());
-
- $response->setStatusCode(Response::STATUS_CODE_CREATED);
-
- return $attribute;
-}
-
-function updateAttribute(
- string $databaseId,
- string $collectionId,
- string $key,
- Database $dbForProject,
- Event $queueForEvents,
- string $type,
- int $size = null,
- string $filter = null,
- string|bool|int|float $default = null,
- bool $required = null,
- int|float|null $min = null,
- int|float|null $max = null,
- array $elements = null,
- array $options = [],
- string $newKey = null,
-): Document {
- $database = $dbForProject->getDocument('databases', $databaseId);
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
- if ($collection->isEmpty()) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- $attribute = $dbForProject->getDocument('attributes', $database->getSequence() . '_' . $collection->getSequence() . '_' . $key);
- if ($attribute->isEmpty()) {
- throw new Exception(Exception::ATTRIBUTE_NOT_FOUND);
- }
-
- if ($attribute->getAttribute('status') !== 'available') {
- throw new Exception(Exception::ATTRIBUTE_NOT_AVAILABLE);
- }
-
- if ($attribute->getAttribute(('type') !== $type)) {
- throw new Exception(Exception::ATTRIBUTE_TYPE_INVALID);
- }
-
- if ($attribute->getAttribute('type') === Database::VAR_STRING && $attribute->getAttribute(('filter') !== $filter)) {
- throw new Exception(Exception::ATTRIBUTE_TYPE_INVALID);
- }
-
- if ($required && isset($default)) {
- throw new Exception(Exception::ATTRIBUTE_DEFAULT_UNSUPPORTED, 'Cannot set default value for required attribute');
- }
-
- if ($attribute->getAttribute('array', false) && isset($default)) {
- throw new Exception(Exception::ATTRIBUTE_DEFAULT_UNSUPPORTED, 'Cannot set default value for array attributes');
- }
-
- $collectionId = 'database_' . $database->getSequence() . '_collection_' . $collection->getSequence();
-
- $attribute
- ->setAttribute('default', $default)
- ->setAttribute('required', $required);
-
- if (!empty($size)) {
- $attribute->setAttribute('size', $size);
- }
-
- switch ($attribute->getAttribute('format')) {
- case APP_DATABASE_ATTRIBUTE_INT_RANGE:
- case APP_DATABASE_ATTRIBUTE_FLOAT_RANGE:
- $min ??= $attribute->getAttribute('formatOptions')['min'];
- $max ??= $attribute->getAttribute('formatOptions')['max'];
-
- if ($min > $max) {
- throw new Exception(Exception::ATTRIBUTE_VALUE_INVALID, 'Minimum value must be lesser than maximum value');
- }
-
- if ($attribute->getAttribute('format') === APP_DATABASE_ATTRIBUTE_INT_RANGE) {
- $validator = new Range($min, $max, Database::VAR_INTEGER);
- } else {
- $validator = new Range($min, $max, Database::VAR_FLOAT);
-
- if (!is_null($default)) {
- $default = \floatval($default);
- }
- }
-
- if (!is_null($default) && !$validator->isValid($default)) {
- throw new Exception(Exception::ATTRIBUTE_VALUE_INVALID, $validator->getDescription());
- }
-
- $options = [
- 'min' => $min,
- 'max' => $max
- ];
- $attribute->setAttribute('formatOptions', $options);
-
- break;
- case APP_DATABASE_ATTRIBUTE_ENUM:
- if (empty($elements)) {
- throw new Exception(Exception::ATTRIBUTE_VALUE_INVALID, 'Enum elements must not be empty');
- }
-
- foreach ($elements as $element) {
- if (\strlen($element) === 0) {
- throw new Exception(Exception::ATTRIBUTE_VALUE_INVALID, 'Each enum element must not be empty');
- }
- }
-
- if (!is_null($default) && !in_array($default, $elements)) {
- throw new Exception(Exception::ATTRIBUTE_VALUE_INVALID, 'Default value not found in elements');
- }
-
- $options = [
- 'elements' => $elements
- ];
-
- $attribute->setAttribute('formatOptions', $options);
-
- break;
- }
-
- if ($type === Database::VAR_RELATIONSHIP) {
- $primaryDocumentOptions = \array_merge($attribute->getAttribute('options', []), $options);
- $attribute->setAttribute('options', $primaryDocumentOptions);
- try {
- $dbForProject->updateRelationship(
- collection: $collectionId,
- id: $key,
- newKey: $newKey,
- onDelete: $primaryDocumentOptions['onDelete'],
- );
- } catch (IndexException) {
- throw new Exception(Exception::INDEX_INVALID);
- } catch (LimitException) {
- throw new Exception(Exception::ATTRIBUTE_LIMIT_EXCEEDED);
- } catch (RelationshipException $e) {
- throw new Exception(Exception::RELATIONSHIP_VALUE_INVALID, $e->getMessage());
- } catch (StructureException $e) {
- throw new Exception(Exception::DOCUMENT_INVALID_STRUCTURE, $e->getMessage());
- }
-
- if ($primaryDocumentOptions['twoWay']) {
- $relatedCollection = $dbForProject->getDocument('database_' . $database->getSequence(), $primaryDocumentOptions['relatedCollection']);
- $relatedAttribute = $dbForProject->getDocument('attributes', $database->getSequence() . '_' . $relatedCollection->getSequence() . '_' . $primaryDocumentOptions['twoWayKey']);
-
- if (!empty($newKey) && $newKey !== $key) {
- $options['twoWayKey'] = $newKey;
- }
-
- $relatedOptions = \array_merge($relatedAttribute->getAttribute('options'), $options);
- $relatedAttribute->setAttribute('options', $relatedOptions);
-
-
- $dbForProject->updateDocument('attributes', $database->getSequence() . '_' . $relatedCollection->getSequence() . '_' . $primaryDocumentOptions['twoWayKey'], $relatedAttribute);
- $dbForProject->purgeCachedDocument('database_' . $database->getSequence(), $relatedCollection->getId());
- }
- } else {
- try {
- $dbForProject->updateAttribute(
- collection: $collectionId,
- id: $key,
- size: $size,
- required: $required,
- default: $default,
- formatOptions: $options,
- newKey: $newKey ?? null
- );
- } catch (DuplicateException) {
- throw new Exception(Exception::DOCUMENT_ALREADY_EXISTS);
- } catch (IndexException $e) {
- throw new Exception(Exception::INDEX_INVALID, $e->getMessage());
- } catch (LimitException) {
- throw new Exception(Exception::ATTRIBUTE_LIMIT_EXCEEDED);
- } catch (TruncateException) {
- throw new Exception(Exception::ATTRIBUTE_INVALID_RESIZE);
- }
- }
-
- if (!empty($newKey) && $key !== $newKey) {
- $originalUid = $attribute->getId();
-
- $attribute
- ->setAttribute('$id', ID::custom($database->getSequence() . '_' . $collection->getSequence() . '_' . $newKey))
- ->setAttribute('key', $newKey);
-
- try {
- $dbForProject->updateDocument('attributes', $originalUid, $attribute);
- } catch (DuplicateException) {
- throw new Exception(Exception::DOCUMENT_ALREADY_EXISTS);
- }
-
- /**
- * @var Document $index
- */
- foreach ($collection->getAttribute('indexes') as $index) {
- /**
- * @var string[] $attributes
- */
- $attributes = $index->getAttribute('attributes', []);
- $found = \array_search($key, $attributes);
-
- if ($found !== false) {
- $attributes[$found] = $newKey;
- $index->setAttribute('attributes', $attributes);
- $dbForProject->updateDocument('indexes', $index->getId(), $index);
- }
- }
- } else {
- $attribute = $dbForProject->updateDocument('attributes', $database->getSequence() . '_' . $collection->getSequence() . '_' . $key, $attribute);
- }
-
- $dbForProject->purgeCachedDocument('database_' . $database->getSequence(), $collection->getId());
-
- $queueForEvents
- ->setContext('collection', $collection)
- ->setContext('database', $database)
- ->setParam('databaseId', $databaseId)
- ->setParam('collectionId', $collection->getId())
- ->setParam('attributeId', $attribute->getId());
-
- return $attribute;
-}
-
-App::init()
- ->groups(['api', 'database'])
- ->inject('request')
- ->inject('dbForProject')
- ->action(function (Request $request, Database $dbForProject) {
- $timeout = \intval($request->getHeader('x-appwrite-timeout'));
-
- if (!empty($timeout) && App::isDevelopment()) {
- $dbForProject->setTimeout($timeout);
- }
- });
-
-App::post('/v1/databases')
- ->desc('Create database')
- ->groups(['api', 'database'])
- ->label('event', 'databases.[databaseId].create')
- ->label('scope', 'databases.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('audits.event', 'database.create')
- ->label('audits.resource', 'database/{response.$id}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'databases',
- name: 'create',
- description: '/docs/references/databases/create.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_CREATED,
- model: Response::MODEL_DATABASE,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new CustomId(), 'Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can\'t start with a special char. Max length is 36 chars.')
- ->param('name', '', new Text(128), 'Database name. Max length: 128 chars.')
- ->param('enabled', true, new Boolean(), 'Is the database enabled? When set to \'disabled\', users cannot access the database but Server SDKs with an API key can still read and write to the database. No data is lost when this is toggled.', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, string $name, bool $enabled, Response $response, Database $dbForProject, Event $queueForEvents) {
-
- $databaseId = $databaseId === 'unique()'
- ? ID::unique()
- : $databaseId;
-
- try {
- $dbForProject->createDocument('databases', new Document([
- '$id' => $databaseId,
- 'name' => $name,
- 'enabled' => $enabled,
- 'search' => implode(' ', [$databaseId, $name]),
- ]));
- } catch (DuplicateException) {
- throw new Exception(Exception::DATABASE_ALREADY_EXISTS);
- } catch (StructureException $e) {
- throw new Exception(Exception::DOCUMENT_INVALID_STRUCTURE, $e->getMessage());
- }
-
- $database = $dbForProject->getDocument('databases', $databaseId);
-
- $collections = (Config::getParam('collections', [])['databases'] ?? [])['collections'] ?? [];
- if (empty($collections)) {
- throw new Exception(Exception::GENERAL_SERVER_ERROR, 'The "collections" collection is not configured.');
- }
-
- $attributes = [];
- foreach ($collections['attributes'] as $attribute) {
- $attributes[] = new Document($attribute);
- }
-
- $indexes = [];
- foreach ($collections['indexes'] as $index) {
- $indexes[] = new Document($index);
- }
-
- try {
- $dbForProject->createCollection('database_' . $database->getSequence(), $attributes, $indexes);
- } catch (DuplicateException) {
- throw new Exception(Exception::DATABASE_ALREADY_EXISTS);
- } catch (IndexException) {
- throw new Exception(Exception::INDEX_INVALID);
- } catch (LimitException) {
- throw new Exception(Exception::COLLECTION_LIMIT_EXCEEDED);
- }
-
- $queueForEvents->setParam('databaseId', $database->getId());
-
- $response
- ->setStatusCode(Response::STATUS_CODE_CREATED)
- ->dynamic($database, Response::MODEL_DATABASE);
- });
-
-App::get('/v1/databases')
- ->desc('List databases')
- ->groups(['api', 'database'])
- ->label('scope', 'databases.read')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'databases',
- name: 'list',
- description: '/docs/references/databases/list.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_DATABASE_LIST,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('queries', [], new Databases(), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long. You may filter on the following attributes: ' . implode(', ', Databases::ALLOWED_ATTRIBUTES), true)
- ->param('search', '', new Text(256), 'Search term to filter your list results. Max length: 256 chars.', true)
- ->inject('response')
- ->inject('dbForProject')
- ->action(function (array $queries, string $search, Response $response, Database $dbForProject) {
- $queries = Query::parseQueries($queries);
-
- if (!empty($search)) {
- $queries[] = Query::search('search', $search);
- }
-
- /**
- * Get cursor document if there was a cursor query, we use array_filter and reset for reference $cursor to $queries
- */
- $cursor = \array_filter($queries, function ($query) {
- return \in_array($query->getMethod(), [Query::TYPE_CURSOR_AFTER, Query::TYPE_CURSOR_BEFORE]);
- });
-
- $cursor = reset($cursor);
- if ($cursor) {
- /** @var Query $cursor */
-
- $validator = new Cursor();
- if (!$validator->isValid($cursor)) {
- throw new Exception(Exception::GENERAL_QUERY_INVALID, $validator->getDescription());
- }
-
- $databaseId = $cursor->getValue();
-
- $cursorDocument = $dbForProject->getDocument('databases', $databaseId);
- if ($cursorDocument->isEmpty()) {
- throw new Exception(Exception::GENERAL_CURSOR_NOT_FOUND, "Database '{$databaseId}' for the 'cursor' value not found.");
- }
-
- $cursor->setValue($cursorDocument);
- }
-
- try {
- $databases = $dbForProject->find('databases', $queries);
- $total = $dbForProject->count('databases', $queries, APP_LIMIT_COUNT);
- } catch (OrderException) {
- throw new Exception(Exception::DATABASE_QUERY_ORDER_NULL);
- } catch (QueryException) {
- throw new Exception(Exception::GENERAL_QUERY_INVALID);
- }
-
- $response->dynamic(new Document([
- 'databases' => $databases,
- 'total' => $total,
- ]), Response::MODEL_DATABASE_LIST);
- });
-
-App::get('/v1/databases/:databaseId')
- ->desc('Get database')
- ->groups(['api', 'database'])
- ->label('scope', 'databases.read')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'databases',
- name: 'get',
- description: '/docs/references/databases/get.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_DATABASE,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->inject('response')
- ->inject('dbForProject')
- ->action(function (string $databaseId, Response $response, Database $dbForProject) {
- $database = $dbForProject->getDocument('databases', $databaseId);
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $response->dynamic($database, Response::MODEL_DATABASE);
- });
-
-App::get('/v1/databases/:databaseId/logs')
- ->desc('List database logs')
- ->groups(['api', 'database'])
- ->label('scope', 'databases.read')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'logs',
- name: 'listLogs',
- description: '/docs/references/databases/get-logs.md',
- auth: [AuthType::ADMIN],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_LOG_LIST,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('queries', [], new Queries([new Limit(), new Offset()]), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Only supported methods are limit and offset', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('locale')
- ->inject('geodb')
- ->action(function (string $databaseId, array $queries, Response $response, Database $dbForProject, Locale $locale, Reader $geodb) {
- $database = $dbForProject->getDocument('databases', $databaseId);
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- try {
- $queries = Query::parseQueries($queries);
- } catch (QueryException $e) {
- throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
- }
-
- // Temp fix for logs
- $queries[] = Query::or([
- Query::greaterThan('$createdAt', DateTime::format(new \DateTime('2025-02-26T01:30+00:00'))),
- Query::lessThan('$createdAt', DateTime::format(new \DateTime('2025-02-13T00:00+00:00'))),
- ]);
-
- $audit = new Audit($dbForProject);
- $resource = 'database/' . $databaseId;
- $logs = $audit->getLogsByResource($resource, $queries);
-
- $output = [];
-
- foreach ($logs as $i => &$log) {
- $log['userAgent'] = (!empty($log['userAgent'])) ? $log['userAgent'] : 'UNKNOWN';
-
- $detector = new Detector($log['userAgent']);
- $detector->skipBotDetection(); // OPTIONAL: If called, bot detection will completely be skipped (bots will be detected as regular devices then)
-
- $os = $detector->getOS();
- $client = $detector->getClient();
- $device = $detector->getDevice();
-
- $output[$i] = new Document([
- 'event' => $log['event'],
- 'userId' => ID::custom($log['data']['userId']),
- 'userEmail' => $log['data']['userEmail'] ?? null,
- 'userName' => $log['data']['userName'] ?? null,
- 'mode' => $log['data']['mode'] ?? null,
- 'ip' => $log['ip'],
- 'time' => $log['time'],
- 'osCode' => $os['osCode'],
- 'osName' => $os['osName'],
- 'osVersion' => $os['osVersion'],
- 'clientType' => $client['clientType'],
- 'clientCode' => $client['clientCode'],
- 'clientName' => $client['clientName'],
- 'clientVersion' => $client['clientVersion'],
- 'clientEngine' => $client['clientEngine'],
- 'clientEngineVersion' => $client['clientEngineVersion'],
- 'deviceName' => $device['deviceName'],
- 'deviceBrand' => $device['deviceBrand'],
- 'deviceModel' => $device['deviceModel']
- ]);
-
- $record = $geodb->get($log['ip']);
-
- if ($record) {
- $output[$i]['countryCode'] = $locale->getText('countries.' . strtolower($record['country']['iso_code']), false) ? \strtolower($record['country']['iso_code']) : '--';
- $output[$i]['countryName'] = $locale->getText('countries.' . strtolower($record['country']['iso_code']), $locale->getText('locale.country.unknown'));
- } else {
- $output[$i]['countryCode'] = '--';
- $output[$i]['countryName'] = $locale->getText('locale.country.unknown');
- }
- }
-
- $response->dynamic(new Document([
- 'total' => $audit->countLogsByResource($resource, $queries),
- 'logs' => $output,
- ]), Response::MODEL_LOG_LIST);
- });
-
-
-App::put('/v1/databases/:databaseId')
- ->desc('Update database')
- ->groups(['api', 'database', 'schema'])
- ->label('scope', 'databases.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('event', 'databases.[databaseId].update')
- ->label('audits.event', 'database.update')
- ->label('audits.resource', 'database/{response.$id}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'databases',
- name: 'update',
- description: '/docs/references/databases/update.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_DATABASE,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('name', null, new Text(128), 'Database name. Max length: 128 chars.')
- ->param('enabled', true, new Boolean(), 'Is database enabled? When set to \'disabled\', users cannot access the database but Server SDKs with an API key can still read and write to the database. No data is lost when this is toggled.', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, string $name, bool $enabled, Response $response, Database $dbForProject, Event $queueForEvents) {
- $database = $dbForProject->getDocument('databases', $databaseId);
-
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $database
- ->setAttribute('name', $name)
- ->setAttribute('enabled', $enabled)
- ->setAttribute('search', implode(' ', [$databaseId, $name]));
-
- $database = $dbForProject->updateDocument('databases', $databaseId, $database);
-
- $queueForEvents->setParam('databaseId', $database->getId());
-
- $response->dynamic($database, Response::MODEL_DATABASE);
- });
-
-App::delete('/v1/databases/:databaseId')
- ->desc('Delete database')
- ->groups(['api', 'database', 'schema'])
- ->label('scope', 'databases.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('event', 'databases.[databaseId].delete')
- ->label('audits.event', 'database.delete')
- ->label('audits.resource', 'database/{request.databaseId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'databases',
- name: 'delete',
- description: '/docs/references/databases/delete.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_NOCONTENT,
- model: Response::MODEL_NONE,
- )
- ],
- contentType: ContentType::NONE
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForDatabase')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, Response $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents) {
- $database = $dbForProject->getDocument('databases', $databaseId);
-
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- if (!$dbForProject->deleteDocument('databases', $databaseId)) {
- throw new Exception(Exception::GENERAL_SERVER_ERROR, 'Failed to remove database from database');
- }
-
- $dbForProject->purgeCachedDocument('databases', $database->getId());
- $dbForProject->purgeCachedCollection('database_' . $database->getSequence());
-
- $queueForDatabase
- ->setType(DATABASE_TYPE_DELETE_DATABASE)
- ->setDatabase($database);
-
- $queueForEvents
- ->setParam('databaseId', $database->getId())
- ->setPayload($response->output($database, Response::MODEL_DATABASE));
-
- $response->noContent();
- });
-
-App::post('/v1/databases/:databaseId/collections')
- ->desc('Create collection')
- ->groups(['api', 'database'])
- ->label('event', 'databases.[databaseId].collections.[collectionId].create')
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('audits.event', 'collection.create')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{response.$id}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'collections',
- name: 'createCollection',
- description: '/docs/references/databases/create-collection.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_CREATED,
- model: Response::MODEL_COLLECTION,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new CustomId(), 'Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can\'t start with a special char. Max length is 36 chars.')
- ->param('name', '', new Text(128), 'Collection name. Max length: 128 chars.')
- ->param('permissions', null, new Permissions(APP_LIMIT_ARRAY_PARAMS_SIZE), 'An array of permissions strings. By default, no user is granted with any permissions. [Learn more about permissions](https://appwrite.io/docs/permissions).', true)
- ->param('documentSecurity', false, new Boolean(true), 'Enables configuring permissions for individual documents. A user needs one of document or collection level permissions to access a document. [Learn more about permissions](https://appwrite.io/docs/permissions).', true)
- ->param('enabled', true, new Boolean(), 'Is collection enabled? When set to \'disabled\', users cannot access the collection but Server SDKs with and API key can still read and write to the collection. No data is lost when this is toggled.', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('mode')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, string $collectionId, string $name, ?array $permissions, bool $documentSecurity, bool $enabled, Response $response, Database $dbForProject, string $mode, Event $queueForEvents) {
- $database = $dbForProject->getDocument('databases', $databaseId);
-
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collectionId = $collectionId === 'unique()'
- ? ID::unique()
- : $collectionId;
-
- // Map aggregate permissions into the multiple permissions they represent.
- $permissions = Permission::aggregate($permissions) ?? [];
-
- try {
- $collection = $dbForProject->createDocument('database_' . $database->getSequence(), new Document([
- '$id' => $collectionId,
- 'databaseInternalId' => $database->getSequence(),
- 'databaseId' => $databaseId,
- '$permissions' => $permissions,
- 'documentSecurity' => $documentSecurity,
- 'enabled' => $enabled,
- 'name' => $name,
- 'search' => implode(' ', [$collectionId, $name]),
- ]));
- } catch (DuplicateException) {
- throw new Exception(Exception::COLLECTION_ALREADY_EXISTS);
- } catch (LimitException) {
- throw new Exception(Exception::COLLECTION_LIMIT_EXCEEDED);
- } catch (NotFoundException) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- try {
- $dbForProject->createCollection(
- id: 'database_' . $database->getSequence() . '_collection_' . $collection->getSequence(),
- permissions: $permissions,
- documentSecurity: $documentSecurity
- );
- } catch (DuplicateException) {
- throw new Exception(Exception::COLLECTION_ALREADY_EXISTS);
- } catch (IndexException) {
- throw new Exception(Exception::INDEX_INVALID);
- } catch (LimitException) {
- throw new Exception(Exception::COLLECTION_LIMIT_EXCEEDED);
- }
-
- $queueForEvents
- ->setContext('database', $database)
- ->setParam('databaseId', $databaseId)
- ->setParam('collectionId', $collection->getId());
-
- $response
- ->setStatusCode(Response::STATUS_CODE_CREATED)
- ->dynamic($collection, Response::MODEL_COLLECTION);
- });
-
-App::get('/v1/databases/:databaseId/collections')
- ->alias('/v1/database/collections')
- ->desc('List collections')
- ->groups(['api', 'database'])
- ->label('scope', 'collections.read')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'collections',
- name: 'listCollections',
- description: '/docs/references/databases/list-collections.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_COLLECTION_LIST,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('queries', [], new Collections(), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long. You may filter on the following attributes: ' . implode(', ', Collections::ALLOWED_ATTRIBUTES), true)
- ->param('search', '', new Text(256), 'Search term to filter your list results. Max length: 256 chars.', true)
- ->inject('response')
- ->inject('dbForProject')
- ->action(function (string $databaseId, array $queries, string $search, Response $response, Database $dbForProject) {
- $database = $dbForProject->getDocument('databases', $databaseId);
-
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- try {
- $queries = Query::parseQueries($queries);
- } catch (QueryException $e) {
- throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
- }
-
- if (!empty($search)) {
- $queries[] = Query::search('search', $search);
- }
-
- /**
- * Get cursor document if there was a cursor query, we use array_filter and reset for reference $cursor to $queries
- */
- $cursor = \array_filter($queries, function ($query) {
- return \in_array($query->getMethod(), [Query::TYPE_CURSOR_AFTER, Query::TYPE_CURSOR_BEFORE]);
- });
- $cursor = reset($cursor);
- if ($cursor) {
- /** @var Query $cursor */
-
- $validator = new Cursor();
- if (!$validator->isValid($cursor)) {
- throw new Exception(Exception::GENERAL_QUERY_INVALID, $validator->getDescription());
- }
-
- $collectionId = $cursor->getValue();
-
- $cursorDocument = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
-
- if ($cursorDocument->isEmpty()) {
- throw new Exception(Exception::GENERAL_CURSOR_NOT_FOUND, "Collection '{$collectionId}' for the 'cursor' value not found.");
- }
-
- $cursor->setValue($cursorDocument);
- }
-
- $collectionId = 'database_' . $database->getSequence();
-
- try {
- $collections = $dbForProject->find($collectionId, $queries);
- $total = $dbForProject->count($collectionId, $queries, APP_LIMIT_COUNT);
- } catch (OrderException) {
- throw new Exception(Exception::DATABASE_QUERY_ORDER_NULL);
- } catch (QueryException) {
- throw new Exception(Exception::GENERAL_QUERY_INVALID);
- }
-
- $response->dynamic(new Document([
- 'collections' => $collections,
- 'total' => $total,
- ]), Response::MODEL_COLLECTION_LIST);
- });
-
-App::get('/v1/databases/:databaseId/collections/:collectionId')
- ->alias('/v1/database/collections/:collectionId')
- ->desc('Get collection')
- ->groups(['api', 'database'])
- ->label('scope', 'collections.read')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'collections',
- name: 'getCollection',
- description: '/docs/references/databases/get-collection.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_COLLECTION,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID.')
- ->inject('response')
- ->inject('dbForProject')
- ->action(function (string $databaseId, string $collectionId, Response $response, Database $dbForProject) {
- $database = $dbForProject->getDocument('databases', $databaseId);
-
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
-
- if ($collection->isEmpty()) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- $response->dynamic($collection, Response::MODEL_COLLECTION);
- });
-
-App::get('/v1/databases/:databaseId/collections/:collectionId/logs')
- ->alias('/v1/database/collections/:collectionId/logs')
- ->desc('List collection logs')
- ->groups(['api', 'database'])
- ->label('scope', 'collections.read')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'collections',
- name: 'listCollectionLogs',
- description: '/docs/references/databases/get-collection-logs.md',
- auth: [AuthType::ADMIN],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_LOG_LIST,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID.')
- ->param('queries', [], new Queries([new Limit(), new Offset()]), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Only supported methods are limit and offset', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('locale')
- ->inject('geodb')
- ->action(function (string $databaseId, string $collectionId, array $queries, Response $response, Database $dbForProject, Locale $locale, Reader $geodb) {
- $database = $dbForProject->getDocument('databases', $databaseId);
-
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collectionDocument = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
- $collection = $dbForProject->getCollection('database_' . $database->getSequence() . '_collection_' . $collectionDocument->getSequence());
-
- if ($collectionDocument->isEmpty() || $collection->isEmpty()) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- try {
- $queries = Query::parseQueries($queries);
- } catch (QueryException $e) {
- throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
- }
-
- // Temp fix for logs
- $queries[] = Query::or([
- Query::greaterThan('$createdAt', DateTime::format(new \DateTime('2025-02-26T01:30+00:00'))),
- Query::lessThan('$createdAt', DateTime::format(new \DateTime('2025-02-13T00:00+00:00'))),
- ]);
-
- $audit = new Audit($dbForProject);
- $resource = 'database/' . $databaseId . '/collection/' . $collectionId;
- $logs = $audit->getLogsByResource($resource, $queries);
-
- $output = [];
-
- foreach ($logs as $i => &$log) {
- $log['userAgent'] = (!empty($log['userAgent'])) ? $log['userAgent'] : 'UNKNOWN';
-
- $detector = new Detector($log['userAgent']);
- $detector->skipBotDetection(); // OPTIONAL: If called, bot detection will completely be skipped (bots will be detected as regular devices then)
-
- $os = $detector->getOS();
- $client = $detector->getClient();
- $device = $detector->getDevice();
-
- $output[$i] = new Document([
- 'event' => $log['event'],
- 'userId' => $log['data']['userId'],
- 'userEmail' => $log['data']['userEmail'] ?? null,
- 'userName' => $log['data']['userName'] ?? null,
- 'mode' => $log['data']['mode'] ?? null,
- 'ip' => $log['ip'],
- 'time' => $log['time'],
- 'osCode' => $os['osCode'],
- 'osName' => $os['osName'],
- 'osVersion' => $os['osVersion'],
- 'clientType' => $client['clientType'],
- 'clientCode' => $client['clientCode'],
- 'clientName' => $client['clientName'],
- 'clientVersion' => $client['clientVersion'],
- 'clientEngine' => $client['clientEngine'],
- 'clientEngineVersion' => $client['clientEngineVersion'],
- 'deviceName' => $device['deviceName'],
- 'deviceBrand' => $device['deviceBrand'],
- 'deviceModel' => $device['deviceModel']
- ]);
-
- $record = $geodb->get($log['ip']);
-
- if ($record) {
- $output[$i]['countryCode'] = $locale->getText('countries.' . strtolower($record['country']['iso_code']), false) ? \strtolower($record['country']['iso_code']) : '--';
- $output[$i]['countryName'] = $locale->getText('countries.' . strtolower($record['country']['iso_code']), $locale->getText('locale.country.unknown'));
- } else {
- $output[$i]['countryCode'] = '--';
- $output[$i]['countryName'] = $locale->getText('locale.country.unknown');
- }
- }
-
- $response->dynamic(new Document([
- 'total' => $audit->countLogsByResource($resource, $queries),
- 'logs' => $output,
- ]), Response::MODEL_LOG_LIST);
- });
-
-
-App::put('/v1/databases/:databaseId/collections/:collectionId')
- ->alias('/v1/database/collections/:collectionId')
- ->desc('Update collection')
- ->groups(['api', 'database', 'schema'])
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('event', 'databases.[databaseId].collections.[collectionId].update')
- ->label('audits.event', 'collection.update')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'collections',
- name: 'updateCollection',
- description: '/docs/references/databases/update-collection.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_COLLECTION,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID.')
- ->param('name', null, new Text(128), 'Collection name. Max length: 128 chars.')
- ->param('permissions', null, new Permissions(APP_LIMIT_ARRAY_PARAMS_SIZE), 'An array of permission strings. By default, the current permissions are inherited. [Learn more about permissions](https://appwrite.io/docs/permissions).', true)
- ->param('documentSecurity', false, new Boolean(true), 'Enables configuring permissions for individual documents. A user needs one of document or collection level permissions to access a document. [Learn more about permissions](https://appwrite.io/docs/permissions).', true)
- ->param('enabled', true, new Boolean(), 'Is collection enabled? When set to \'disabled\', users cannot access the collection but Server SDKs with and API key can still read and write to the collection. No data is lost when this is toggled.', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('mode')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, string $collectionId, string $name, ?array $permissions, bool $documentSecurity, bool $enabled, Response $response, Database $dbForProject, string $mode, Event $queueForEvents) {
- $database = $dbForProject->getDocument('databases', $databaseId);
-
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
-
- if ($collection->isEmpty()) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- $permissions ??= $collection->getPermissions() ?? [];
-
- // Map aggregate permissions into the multiple permissions they represent.
- $permissions = Permission::aggregate($permissions);
-
- $enabled ??= $collection->getAttribute('enabled', true);
-
- $collection
- ->setAttribute('name', $name)
- ->setAttribute('$permissions', $permissions)
- ->setAttribute('documentSecurity', $documentSecurity)
- ->setAttribute('enabled', $enabled)
- ->setAttribute('search', \implode(' ', [$collectionId, $name]));
-
- $collection = $dbForProject->updateDocument(
- 'database_' . $database->getSequence(),
- $collectionId,
- $collection
- );
-
- $dbForProject->updateCollection('database_' . $database->getSequence() . '_collection_' . $collection->getSequence(), $permissions, $documentSecurity);
-
- $queueForEvents
- ->setContext('database', $database)
- ->setParam('databaseId', $databaseId)
- ->setParam('collectionId', $collection->getId());
-
- $response->dynamic($collection, Response::MODEL_COLLECTION);
- });
-
-App::delete('/v1/databases/:databaseId/collections/:collectionId')
- ->alias('/v1/database/collections/:collectionId')
- ->desc('Delete collection')
- ->groups(['api', 'database', 'schema'])
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('event', 'databases.[databaseId].collections.[collectionId].delete')
- ->label('audits.event', 'collection.delete')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'collections',
- name: 'deleteCollection',
- description: '/docs/references/databases/delete-collection.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_NOCONTENT,
- model: Response::MODEL_NONE,
- )
- ],
- contentType: ContentType::NONE
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID.')
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForDatabase')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, string $collectionId, Response $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents) {
- $database = $dbForProject->getDocument('databases', $databaseId);
-
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
-
- if ($collection->isEmpty()) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- if (!$dbForProject->deleteDocument('database_' . $database->getSequence(), $collectionId)) {
- throw new Exception(Exception::GENERAL_SERVER_ERROR, 'Failed to remove collection from DB');
- }
-
- $dbForProject->purgeCachedCollection('database_' . $database->getSequence() . '_collection_' . $collection->getSequence());
-
- $queueForDatabase
- ->setType(DATABASE_TYPE_DELETE_COLLECTION)
- ->setDatabase($database)
- ->setCollection($collection);
-
- $queueForEvents
- ->setContext('database', $database)
- ->setParam('databaseId', $databaseId)
- ->setParam('collectionId', $collection->getId())
- ->setPayload($response->output($collection, Response::MODEL_COLLECTION));
-
- $response->noContent();
- });
-
-App::post('/v1/databases/:databaseId/collections/:collectionId/attributes/string')
- ->alias('/v1/database/collections/:collectionId/attributes/string')
- ->desc('Create string attribute')
- ->groups(['api', 'database', 'schema'])
- ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].create')
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('audits.event', 'attribute.create')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'attributes',
- name: 'createStringAttribute',
- description: '/docs/references/databases/create-string-attribute.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_ACCEPTED,
- model: Response::MODEL_ATTRIBUTE_STRING
- )
- ]
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('key', '', new Key(), 'Attribute Key.')
- ->param('size', null, new Range(1, APP_DATABASE_ATTRIBUTE_STRING_MAX_LENGTH, Range::TYPE_INTEGER), 'Attribute size for text attributes, in number of characters.')
- ->param('required', null, new Boolean(), 'Is attribute required?')
- ->param('default', null, new Text(0, 0), 'Default value for attribute when not provided. Cannot be set when attribute is required.', true)
- ->param('array', false, new Boolean(), 'Is attribute an array?', true)
- ->param('encrypt', false, new Boolean(), 'Toggle encryption for the attribute. Encryption enhances security by not storing any plain text values in the database. However, encrypted attributes cannot be queried.', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForDatabase')
- ->inject('queueForEvents')
- ->inject('plan')
- ->action(function (string $databaseId, string $collectionId, string $key, ?int $size, ?bool $required, ?string $default, bool $array, bool $encrypt, Response $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents, array $plan) {
- if (!App::isDevelopment() && $encrypt && !empty($plan) && !($plan['databasesAllowEncrypt'] ?? false)) {
- throw new Exception(Exception::GENERAL_BAD_REQUEST, 'Encrypted string attributes are not available on your plan. Please upgrade to create encrypted string attributes.');
- }
- if ($encrypt && $size < APP_DATABASE_ENCRYPT_SIZE_MIN) {
- throw new Exception(
- Exception::GENERAL_BAD_REQUEST,
- "Size too small. Encrypted strings require a minimum size of " . APP_DATABASE_ENCRYPT_SIZE_MIN . " characters."
- );
- }
- // Ensure attribute default is within required size
- $validator = new Text($size, 0);
- if (!is_null($default) && !$validator->isValid($default)) {
- throw new Exception(Exception::ATTRIBUTE_VALUE_INVALID, $validator->getDescription());
- }
-
- $filters = [];
- if ($encrypt) {
- $filters[] = 'encrypt';
- }
-
- $attribute = createAttribute($databaseId, $collectionId, new Document([
- 'key' => $key,
- 'type' => Database::VAR_STRING,
- 'size' => $size,
- 'required' => $required,
- 'default' => $default,
- 'array' => $array,
- 'filters' => $filters,
- ]), $response, $dbForProject, $queueForDatabase, $queueForEvents);
- $attribute->setAttribute('encrypt', $encrypt);
- $response
- ->setStatusCode(Response::STATUS_CODE_ACCEPTED)
- ->dynamic($attribute, Response::MODEL_ATTRIBUTE_STRING);
- });
-
-App::post('/v1/databases/:databaseId/collections/:collectionId/attributes/email')
- ->alias('/v1/database/collections/:collectionId/attributes/email')
- ->desc('Create email attribute')
- ->groups(['api', 'database', 'schema'])
- ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].create')
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('audits.event', 'attribute.create')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'attributes',
- name: 'createEmailAttribute',
- description: '/docs/references/databases/create-email-attribute.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_ACCEPTED,
- model: Response::MODEL_ATTRIBUTE_EMAIL,
- )
- ]
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('key', '', new Key(), 'Attribute Key.')
- ->param('required', null, new Boolean(), 'Is attribute required?')
- ->param('default', null, new Email(), 'Default value for attribute when not provided. Cannot be set when attribute is required.', true)
- ->param('array', false, new Boolean(), 'Is attribute an array?', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForDatabase')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, string $collectionId, string $key, ?bool $required, ?string $default, bool $array, Response $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents) {
- $attribute = createAttribute($databaseId, $collectionId, new Document([
- 'key' => $key,
- 'type' => Database::VAR_STRING,
- 'size' => 254,
- 'required' => $required,
- 'default' => $default,
- 'array' => $array,
- 'format' => APP_DATABASE_ATTRIBUTE_EMAIL,
- ]), $response, $dbForProject, $queueForDatabase, $queueForEvents);
-
- $response
- ->setStatusCode(Response::STATUS_CODE_ACCEPTED)
- ->dynamic($attribute, Response::MODEL_ATTRIBUTE_EMAIL);
- });
-
-App::post('/v1/databases/:databaseId/collections/:collectionId/attributes/enum')
- ->alias('/v1/database/collections/:collectionId/attributes/enum')
- ->desc('Create enum attribute')
- ->groups(['api', 'database', 'schema'])
- ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].create')
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('audits.event', 'attribute.create')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'attributes',
- name: 'createEnumAttribute',
- description: '/docs/references/databases/create-attribute-enum.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_ACCEPTED,
- model: Response::MODEL_ATTRIBUTE_ENUM,
- )
- ]
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('key', '', new Key(), 'Attribute Key.')
- ->param('elements', [], new ArrayList(new Text(DATABASE::LENGTH_KEY), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Array of elements in enumerated type. Uses length of longest element to determine size. Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' elements are allowed, each ' . DATABASE::LENGTH_KEY . ' characters long.')
- ->param('required', null, new Boolean(), 'Is attribute required?')
- ->param('default', null, new Text(0), 'Default value for attribute when not provided. Cannot be set when attribute is required.', true)
- ->param('array', false, new Boolean(), 'Is attribute an array?', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForDatabase')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, string $collectionId, string $key, array $elements, ?bool $required, ?string $default, bool $array, Response $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents) {
- if (!is_null($default) && !in_array($default, $elements)) {
- throw new Exception(Exception::ATTRIBUTE_VALUE_INVALID, 'Default value not found in elements');
- }
-
- $attribute = createAttribute($databaseId, $collectionId, new Document([
- 'key' => $key,
- 'type' => Database::VAR_STRING,
- 'size' => Database::LENGTH_KEY,
- 'required' => $required,
- 'default' => $default,
- 'array' => $array,
- 'format' => APP_DATABASE_ATTRIBUTE_ENUM,
- 'formatOptions' => ['elements' => $elements],
- ]), $response, $dbForProject, $queueForDatabase, $queueForEvents);
-
- $response
- ->setStatusCode(Response::STATUS_CODE_ACCEPTED)
- ->dynamic($attribute, Response::MODEL_ATTRIBUTE_ENUM);
- });
-
-App::post('/v1/databases/:databaseId/collections/:collectionId/attributes/ip')
- ->alias('/v1/database/collections/:collectionId/attributes/ip')
- ->desc('Create IP address attribute')
- ->groups(['api', 'database', 'schema'])
- ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].create')
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('audits.event', 'attribute.create')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'attributes',
- name: 'createIpAttribute',
- description: '/docs/references/databases/create-ip-attribute.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_ACCEPTED,
- model: Response::MODEL_ATTRIBUTE_IP,
- )
- ]
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('key', '', new Key(), 'Attribute Key.')
- ->param('required', null, new Boolean(), 'Is attribute required?')
- ->param('default', null, new IP(), 'Default value for attribute when not provided. Cannot be set when attribute is required.', true)
- ->param('array', false, new Boolean(), 'Is attribute an array?', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForDatabase')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, string $collectionId, string $key, ?bool $required, ?string $default, bool $array, Response $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents) {
- $attribute = createAttribute($databaseId, $collectionId, new Document([
- 'key' => $key,
- 'type' => Database::VAR_STRING,
- 'size' => 39,
- 'required' => $required,
- 'default' => $default,
- 'array' => $array,
- 'format' => APP_DATABASE_ATTRIBUTE_IP,
- ]), $response, $dbForProject, $queueForDatabase, $queueForEvents);
-
- $response
- ->setStatusCode(Response::STATUS_CODE_ACCEPTED)
- ->dynamic($attribute, Response::MODEL_ATTRIBUTE_IP);
- });
-
-App::post('/v1/databases/:databaseId/collections/:collectionId/attributes/url')
- ->alias('/v1/database/collections/:collectionId/attributes/url')
- ->desc('Create URL attribute')
- ->groups(['api', 'database', 'schema'])
- ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].create')
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('audits.event', 'attribute.create')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'attributes',
- name: 'createUrlAttribute',
- description: '/docs/references/databases/create-url-attribute.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_ACCEPTED,
- model: Response::MODEL_ATTRIBUTE_URL,
- )
- ]
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('key', '', new Key(), 'Attribute Key.')
- ->param('required', null, new Boolean(), 'Is attribute required?')
- ->param('default', null, new URL(), 'Default value for attribute when not provided. Cannot be set when attribute is required.', true)
- ->param('array', false, new Boolean(), 'Is attribute an array?', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForDatabase')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, string $collectionId, string $key, ?bool $required, ?string $default, bool $array, Response $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents) {
- $attribute = createAttribute($databaseId, $collectionId, new Document([
- 'key' => $key,
- 'type' => Database::VAR_STRING,
- 'size' => 2000,
- 'required' => $required,
- 'default' => $default,
- 'array' => $array,
- 'format' => APP_DATABASE_ATTRIBUTE_URL,
- ]), $response, $dbForProject, $queueForDatabase, $queueForEvents);
-
- $response
- ->setStatusCode(Response::STATUS_CODE_ACCEPTED)
- ->dynamic($attribute, Response::MODEL_ATTRIBUTE_URL);
- });
-
-App::post('/v1/databases/:databaseId/collections/:collectionId/attributes/integer')
- ->alias('/v1/database/collections/:collectionId/attributes/integer')
- ->desc('Create integer attribute')
- ->groups(['api', 'database', 'schema'])
- ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].create')
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('audits.event', 'attribute.create')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'attributes',
- name: 'createIntegerAttribute',
- description: '/docs/references/databases/create-integer-attribute.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_ACCEPTED,
- model: Response::MODEL_ATTRIBUTE_INTEGER,
- )
- ]
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('key', '', new Key(), 'Attribute Key.')
- ->param('required', null, new Boolean(), 'Is attribute required?')
- ->param('min', null, new Integer(), 'Minimum value to enforce on new documents', true)
- ->param('max', null, new Integer(), 'Maximum value to enforce on new documents', true)
- ->param('default', null, new Integer(), 'Default value for attribute when not provided. Cannot be set when attribute is required.', true)
- ->param('array', false, new Boolean(), 'Is attribute an array?', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForDatabase')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, string $collectionId, string $key, ?bool $required, ?int $min, ?int $max, ?int $default, bool $array, Response $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents) {
- // Ensure attribute default is within range
- $min ??= PHP_INT_MIN;
- $max ??= PHP_INT_MAX;
-
- if ($min > $max) {
- throw new Exception(Exception::ATTRIBUTE_VALUE_INVALID, 'Minimum value must be lesser than maximum value');
- }
-
- $validator = new Range($min, $max, Database::VAR_INTEGER);
-
- if (!is_null($default) && !$validator->isValid($default)) {
- throw new Exception(Exception::ATTRIBUTE_VALUE_INVALID, $validator->getDescription());
- }
-
- $size = $max > 2147483647 ? 8 : 4; // Automatically create BigInt depending on max value
-
- $attribute = createAttribute($databaseId, $collectionId, new Document([
- 'key' => $key,
- 'type' => Database::VAR_INTEGER,
- 'size' => $size,
- 'required' => $required,
- 'default' => $default,
- 'array' => $array,
- 'format' => APP_DATABASE_ATTRIBUTE_INT_RANGE,
- 'formatOptions' => [
- 'min' => $min,
- 'max' => $max,
- ],
- ]), $response, $dbForProject, $queueForDatabase, $queueForEvents);
-
- $formatOptions = $attribute->getAttribute('formatOptions', []);
-
- if (!empty($formatOptions)) {
- $attribute->setAttribute('min', \intval($formatOptions['min']));
- $attribute->setAttribute('max', \intval($formatOptions['max']));
- }
-
- $response
- ->setStatusCode(Response::STATUS_CODE_ACCEPTED)
- ->dynamic($attribute, Response::MODEL_ATTRIBUTE_INTEGER);
- });
-
-App::post('/v1/databases/:databaseId/collections/:collectionId/attributes/float')
- ->alias('/v1/database/collections/:collectionId/attributes/float')
- ->desc('Create float attribute')
- ->groups(['api', 'database', 'schema'])
- ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].create')
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('audits.event', 'attribute.create')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'attributes',
- name: 'createFloatAttribute',
- description: '/docs/references/databases/create-float-attribute.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_ACCEPTED,
- model: Response::MODEL_ATTRIBUTE_FLOAT,
- )
- ]
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('key', '', new Key(), 'Attribute Key.')
- ->param('required', null, new Boolean(), 'Is attribute required?')
- ->param('min', null, new FloatValidator(), 'Minimum value to enforce on new documents', true)
- ->param('max', null, new FloatValidator(), 'Maximum value to enforce on new documents', true)
- ->param('default', null, new FloatValidator(), 'Default value for attribute when not provided. Cannot be set when attribute is required.', true)
- ->param('array', false, new Boolean(), 'Is attribute an array?', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForDatabase')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, string $collectionId, string $key, ?bool $required, ?float $min, ?float $max, ?float $default, bool $array, Response $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents) {
- // Ensure attribute default is within range
- $min ??= -PHP_FLOAT_MAX;
- $max ??= PHP_FLOAT_MAX;
-
- if ($min > $max) {
- throw new Exception(Exception::ATTRIBUTE_VALUE_INVALID, 'Minimum value must be lesser than maximum value');
- }
-
- $validator = new Range($min, $max, Database::VAR_FLOAT);
-
- if (!\is_null($default) && !$validator->isValid($default)) {
- throw new Exception(Exception::ATTRIBUTE_VALUE_INVALID, $validator->getDescription());
- }
-
- $attribute = createAttribute($databaseId, $collectionId, new Document([
- 'key' => $key,
- 'type' => Database::VAR_FLOAT,
- 'required' => $required,
- 'size' => 0,
- 'default' => $default,
- 'array' => $array,
- 'format' => APP_DATABASE_ATTRIBUTE_FLOAT_RANGE,
- 'formatOptions' => [
- 'min' => $min,
- 'max' => $max,
- ],
- ]), $response, $dbForProject, $queueForDatabase, $queueForEvents);
-
- $formatOptions = $attribute->getAttribute('formatOptions', []);
-
- if (!empty($formatOptions)) {
- $attribute->setAttribute('min', \floatval($formatOptions['min']));
- $attribute->setAttribute('max', \floatval($formatOptions['max']));
- }
-
- $response
- ->setStatusCode(Response::STATUS_CODE_ACCEPTED)
- ->dynamic($attribute, Response::MODEL_ATTRIBUTE_FLOAT);
- });
-
-App::post('/v1/databases/:databaseId/collections/:collectionId/attributes/boolean')
- ->alias('/v1/database/collections/:collectionId/attributes/boolean')
- ->desc('Create boolean attribute')
- ->groups(['api', 'database', 'schema'])
- ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].create')
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('audits.event', 'attribute.create')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'attributes',
- name: 'createBooleanAttribute',
- description: '/docs/references/databases/create-boolean-attribute.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_ACCEPTED,
- model: Response::MODEL_ATTRIBUTE_BOOLEAN,
- )
- ]
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('key', '', new Key(), 'Attribute Key.')
- ->param('required', null, new Boolean(), 'Is attribute required?')
- ->param('default', null, new Boolean(), 'Default value for attribute when not provided. Cannot be set when attribute is required.', true)
- ->param('array', false, new Boolean(), 'Is attribute an array?', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForDatabase')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, string $collectionId, string $key, ?bool $required, ?bool $default, bool $array, Response $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents) {
- $attribute = createAttribute($databaseId, $collectionId, new Document([
- 'key' => $key,
- 'type' => Database::VAR_BOOLEAN,
- 'size' => 0,
- 'required' => $required,
- 'default' => $default,
- 'array' => $array,
- ]), $response, $dbForProject, $queueForDatabase, $queueForEvents);
-
- $response
- ->setStatusCode(Response::STATUS_CODE_ACCEPTED)
- ->dynamic($attribute, Response::MODEL_ATTRIBUTE_BOOLEAN);
- });
-
-App::post('/v1/databases/:databaseId/collections/:collectionId/attributes/datetime')
- ->alias('/v1/database/collections/:collectionId/attributes/datetime')
- ->desc('Create datetime attribute')
- ->groups(['api', 'database'])
- ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].create')
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('audits.event', 'attribute.create')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'attributes',
- name: 'createDatetimeAttribute',
- description: '/docs/references/databases/create-datetime-attribute.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_ACCEPTED,
- model: Response::MODEL_ATTRIBUTE_DATETIME,
- )
- ]
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('key', '', new Key(), 'Attribute Key.')
- ->param('required', null, new Boolean(), 'Is attribute required?')
- ->param('default', null, fn (Database $dbForProject) => new DatetimeValidator($dbForProject->getAdapter()->getMinDateTime(), $dbForProject->getAdapter()->getMaxDateTime()), 'Default value for the attribute in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. Cannot be set when attribute is required.', true, ['dbForProject'])
- ->param('array', false, new Boolean(), 'Is attribute an array?', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForDatabase')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, string $collectionId, string $key, ?bool $required, ?string $default, bool $array, Response $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents) {
- $filters[] = 'datetime';
-
- $attribute = createAttribute($databaseId, $collectionId, new Document([
- 'key' => $key,
- 'type' => Database::VAR_DATETIME,
- 'size' => 0,
- 'required' => $required,
- 'default' => $default,
- 'array' => $array,
- 'filters' => $filters,
- ]), $response, $dbForProject, $queueForDatabase, $queueForEvents);
-
- $response
- ->setStatusCode(Response::STATUS_CODE_ACCEPTED)
- ->dynamic($attribute, Response::MODEL_ATTRIBUTE_DATETIME);
- });
-
-App::post('/v1/databases/:databaseId/collections/:collectionId/attributes/relationship')
- ->alias('/v1/database/collections/:collectionId/attributes/relationship')
- ->desc('Create relationship attribute')
- ->groups(['api', 'database'])
- ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].create')
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('audits.event', 'attribute.create')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'attributes',
- name: 'createRelationshipAttribute',
- description: '/docs/references/databases/create-relationship-attribute.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_ACCEPTED,
- model: Response::MODEL_ATTRIBUTE_RELATIONSHIP,
- )
- ]
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('relatedCollectionId', '', new UID(), 'Related Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('type', '', new WhiteList([Database::RELATION_ONE_TO_ONE, Database::RELATION_MANY_TO_ONE, Database::RELATION_MANY_TO_MANY, Database::RELATION_ONE_TO_MANY], true), 'Relation type')
- ->param('twoWay', false, new Boolean(), 'Is Two Way?', true)
- ->param('key', null, new Key(), 'Attribute Key.', true)
- ->param('twoWayKey', null, new Key(), 'Two Way Attribute Key.', true)
- ->param('onDelete', Database::RELATION_MUTATE_RESTRICT, new WhiteList([Database::RELATION_MUTATE_CASCADE, Database::RELATION_MUTATE_RESTRICT, Database::RELATION_MUTATE_SET_NULL], true), 'Constraints option', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForDatabase')
- ->inject('queueForEvents')
- ->action(function (
- string $databaseId,
- string $collectionId,
- string $relatedCollectionId,
- string $type,
- bool $twoWay,
- ?string $key,
- ?string $twoWayKey,
- string $onDelete,
- Response $response,
- Database $dbForProject,
- EventDatabase $queueForDatabase,
- Event $queueForEvents
- ) {
- $key ??= $relatedCollectionId;
- $twoWayKey ??= $collectionId;
-
- $database = $dbForProject->getDocument('databases', $databaseId);
-
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
- $collection = $dbForProject->getCollection('database_' . $database->getSequence() . '_collection_' . $collection->getSequence());
-
- if ($collection->isEmpty()) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- $relatedCollectionDocument = $dbForProject->getDocument('database_' . $database->getSequence(), $relatedCollectionId);
- $relatedCollection = $dbForProject->getCollection('database_' . $database->getSequence() . '_collection_' . $relatedCollectionDocument->getSequence());
-
- if ($relatedCollection->isEmpty()) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- $attributes = $collection->getAttribute('attributes', []);
-
- /** @var Document[] $attributes */
- foreach ($attributes as $attribute) {
- if ($attribute->getAttribute('type') !== Database::VAR_RELATIONSHIP) {
- continue;
- }
-
- if (\strtolower($attribute->getId()) === \strtolower($key)) {
- throw new Exception(Exception::ATTRIBUTE_ALREADY_EXISTS);
- }
-
- if (
- \strtolower($attribute->getAttribute('options')['twoWayKey']) === \strtolower($twoWayKey) &&
- $attribute->getAttribute('options')['relatedCollection'] === $relatedCollection->getId()
- ) {
- // Console should provide a unique twoWayKey input!
- throw new Exception(Exception::ATTRIBUTE_ALREADY_EXISTS, 'Attribute with the requested key already exists. Attribute keys must be unique, try again with a different key.');
- }
-
- if (
- $type === Database::RELATION_MANY_TO_MANY &&
- $attribute->getAttribute('options')['relationType'] === Database::RELATION_MANY_TO_MANY &&
- $attribute->getAttribute('options')['relatedCollection'] === $relatedCollection->getId()
- ) {
- throw new Exception(Exception::ATTRIBUTE_ALREADY_EXISTS, 'Creating more than one "manyToMany" relationship on the same collection is currently not permitted.');
- }
- }
-
- $attribute = createAttribute(
- $databaseId,
- $collectionId,
- new Document([
- 'key' => $key,
- 'type' => Database::VAR_RELATIONSHIP,
- 'size' => 0,
- 'required' => false,
- 'default' => null,
- 'array' => false,
- 'filters' => [],
- 'options' => [
- 'relatedCollection' => $relatedCollectionId,
- 'relationType' => $type,
- 'twoWay' => $twoWay,
- 'twoWayKey' => $twoWayKey,
- 'onDelete' => $onDelete,
- ]
- ]),
- $response,
- $dbForProject,
- $queueForDatabase,
- $queueForEvents
- );
-
- $options = $attribute->getAttribute('options', []);
-
- foreach ($options as $key => $option) {
- $attribute->setAttribute($key, $option);
- }
-
- $response
- ->setStatusCode(Response::STATUS_CODE_ACCEPTED)
- ->dynamic($attribute, Response::MODEL_ATTRIBUTE_RELATIONSHIP);
- });
-
-App::get('/v1/databases/:databaseId/collections/:collectionId/attributes')
- ->alias('/v1/database/collections/:collectionId/attributes')
- ->desc('List attributes')
- ->groups(['api', 'database'])
- ->label('scope', 'collections.read')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'attributes',
- name: 'listAttributes',
- description: '/docs/references/databases/list-attributes.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_ATTRIBUTE_LIST
- )
- ]
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('queries', [], new Attributes(), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long. You may filter on the following attributes: ' . implode(', ', Attributes::ALLOWED_ATTRIBUTES), true)
- ->inject('response')
- ->inject('dbForProject')
- ->action(function (string $databaseId, string $collectionId, array $queries, Response $response, Database $dbForProject) {
- $database = $dbForProject->getDocument('databases', $databaseId);
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
- if ($collection->isEmpty()) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- try {
- $queries = Query::parseQueries($queries);
- } catch (QueryException $e) {
- throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
- }
-
- \array_push(
- $queries,
- Query::equal('databaseInternalId', [$database->getSequence()]),
- Query::equal('collectionInternalId', [$collection->getSequence()]),
- );
-
- /**
- * Get cursor document if there was a cursor query, we use array_filter and reset for reference $cursor to $queries
- */
- $cursor = \array_filter($queries, function ($query) {
- return \in_array($query->getMethod(), [Query::TYPE_CURSOR_AFTER, Query::TYPE_CURSOR_BEFORE]);
- });
-
- $cursor = \reset($cursor);
-
- if ($cursor) {
- $validator = new Cursor();
- if (!$validator->isValid($cursor)) {
- throw new Exception(Exception::GENERAL_QUERY_INVALID, $validator->getDescription());
- }
-
- $attributeId = $cursor->getValue();
-
- try {
- $cursorDocument = $dbForProject->findOne('attributes', [
- Query::equal('databaseInternalId', [$database->getSequence()]),
- Query::equal('collectionInternalId', [$collection->getSequence()]),
- Query::equal('key', [$attributeId]),
- ]);
- } catch (QueryException $e) {
- throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
- }
-
- if ($cursorDocument->isEmpty()) {
- throw new Exception(Exception::GENERAL_CURSOR_NOT_FOUND, "Attribute '{$attributeId}' for the 'cursor' value not found.");
- }
-
- $cursor->setValue($cursorDocument);
- }
-
- try {
- $attributes = $dbForProject->find('attributes', $queries);
- $total = $dbForProject->count('attributes', $queries, APP_LIMIT_COUNT);
- } catch (OrderException) {
- throw new Exception(Exception::DATABASE_QUERY_ORDER_NULL);
- } catch (QueryException) {
- throw new Exception(Exception::GENERAL_QUERY_INVALID);
- }
-
- foreach ($attributes as $attribute) {
- if ($attribute->getAttribute('type') === Database::VAR_STRING) {
- $filters = $attribute->getAttribute('filters', []);
- $attribute->setAttribute('encrypt', in_array('encrypt', $filters));
- }
- }
-
- $response->dynamic(new Document([
- 'attributes' => $attributes,
- 'total' => $total,
- ]), Response::MODEL_ATTRIBUTE_LIST);
- });
-
-App::get('/v1/databases/:databaseId/collections/:collectionId/attributes/:key')
- ->alias('/v1/database/collections/:collectionId/attributes/:key')
- ->desc('Get attribute')
- ->groups(['api', 'database'])
- ->label('scope', 'collections.read')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'attributes',
- name: 'getAttribute',
- description: '/docs/references/databases/get-attribute.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: [
- Response::MODEL_ATTRIBUTE_BOOLEAN,
- Response::MODEL_ATTRIBUTE_INTEGER,
- Response::MODEL_ATTRIBUTE_FLOAT,
- Response::MODEL_ATTRIBUTE_EMAIL,
- Response::MODEL_ATTRIBUTE_ENUM,
- Response::MODEL_ATTRIBUTE_URL,
- Response::MODEL_ATTRIBUTE_IP,
- Response::MODEL_ATTRIBUTE_DATETIME,
- Response::MODEL_ATTRIBUTE_RELATIONSHIP,
- Response::MODEL_ATTRIBUTE_STRING
- ]
- ),
- ]
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('key', '', new Key(), 'Attribute Key.')
- ->inject('response')
- ->inject('dbForProject')
- ->action(function (string $databaseId, string $collectionId, string $key, Response $response, Database $dbForProject) {
- $database = $dbForProject->getDocument('databases', $databaseId);
-
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
-
- if ($collection->isEmpty()) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- $attribute = $dbForProject->getDocument('attributes', $database->getSequence() . '_' . $collection->getSequence() . '_' . $key);
-
- if ($attribute->isEmpty()) {
- throw new Exception(Exception::ATTRIBUTE_NOT_FOUND);
- }
-
- // Select response model based on type and format
- $type = $attribute->getAttribute('type');
- $format = $attribute->getAttribute('format');
- $options = $attribute->getAttribute('options', []);
- $filters = $attribute->getAttribute('filters', []);
- foreach ($options as $key => $option) {
- $attribute->setAttribute($key, $option);
- }
-
- $model = match ($type) {
- Database::VAR_BOOLEAN => Response::MODEL_ATTRIBUTE_BOOLEAN,
- Database::VAR_INTEGER => Response::MODEL_ATTRIBUTE_INTEGER,
- Database::VAR_FLOAT => Response::MODEL_ATTRIBUTE_FLOAT,
- Database::VAR_DATETIME => Response::MODEL_ATTRIBUTE_DATETIME,
- Database::VAR_RELATIONSHIP => Response::MODEL_ATTRIBUTE_RELATIONSHIP,
- Database::VAR_STRING => match ($format) {
- APP_DATABASE_ATTRIBUTE_EMAIL => Response::MODEL_ATTRIBUTE_EMAIL,
- APP_DATABASE_ATTRIBUTE_ENUM => Response::MODEL_ATTRIBUTE_ENUM,
- APP_DATABASE_ATTRIBUTE_IP => Response::MODEL_ATTRIBUTE_IP,
- APP_DATABASE_ATTRIBUTE_URL => Response::MODEL_ATTRIBUTE_URL,
- default => Response::MODEL_ATTRIBUTE_STRING,
- },
- default => Response::MODEL_ATTRIBUTE,
- };
- $attribute->setAttribute('encrypt', in_array('encrypt', $filters));
- $response->dynamic($attribute, $model);
- });
-
-App::patch('/v1/databases/:databaseId/collections/:collectionId/attributes/string/:key')
- ->desc('Update string attribute')
- ->groups(['api', 'database', 'schema'])
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].update')
- ->label('audits.event', 'attribute.update')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'attributes',
- name: 'updateStringAttribute',
- description: '/docs/references/databases/update-string-attribute.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_ATTRIBUTE_STRING,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('key', '', new Key(), 'Attribute Key.')
- ->param('required', null, new Boolean(), 'Is attribute required?')
- ->param('default', null, new Nullable(new Text(0, 0)), 'Default value for attribute when not provided. Cannot be set when attribute is required.')
- ->param('size', null, new Range(1, APP_DATABASE_ATTRIBUTE_STRING_MAX_LENGTH, Range::TYPE_INTEGER), 'Maximum size of the string attribute.', true)
- ->param('newKey', null, new Key(), 'New attribute key.', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, string $collectionId, string $key, ?bool $required, ?string $default, ?int $size, ?string $newKey, Response $response, Database $dbForProject, Event $queueForEvents) {
- $attribute = updateAttribute(
- databaseId: $databaseId,
- collectionId: $collectionId,
- key: $key,
- dbForProject: $dbForProject,
- queueForEvents: $queueForEvents,
- type: Database::VAR_STRING,
- size: $size,
- default: $default,
- required: $required,
- newKey: $newKey
- );
-
- $response
- ->setStatusCode(Response::STATUS_CODE_OK)
- ->dynamic($attribute, Response::MODEL_ATTRIBUTE_STRING);
- });
-
-App::patch('/v1/databases/:databaseId/collections/:collectionId/attributes/email/:key')
- ->desc('Update email attribute')
- ->groups(['api', 'database', 'schema'])
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].update')
- ->label('audits.event', 'attribute.update')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'attributes',
- name: 'updateEmailAttribute',
- description: '/docs/references/databases/update-email-attribute.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_ATTRIBUTE_EMAIL,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('key', '', new Key(), 'Attribute Key.')
- ->param('required', null, new Boolean(), 'Is attribute required?')
- ->param('default', null, new Nullable(new Email()), 'Default value for attribute when not provided. Cannot be set when attribute is required.')
- ->param('newKey', null, new Key(), 'New attribute key.', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, string $collectionId, string $key, ?bool $required, ?string $default, ?string $newKey, Response $response, Database $dbForProject, Event $queueForEvents) {
- $attribute = updateAttribute(
- databaseId: $databaseId,
- collectionId: $collectionId,
- key: $key,
- dbForProject: $dbForProject,
- queueForEvents: $queueForEvents,
- type: Database::VAR_STRING,
- filter: APP_DATABASE_ATTRIBUTE_EMAIL,
- default: $default,
- required: $required,
- newKey: $newKey
- );
-
- $response
- ->setStatusCode(Response::STATUS_CODE_OK)
- ->dynamic($attribute, Response::MODEL_ATTRIBUTE_EMAIL);
- });
-
-App::patch('/v1/databases/:databaseId/collections/:collectionId/attributes/enum/:key')
- ->desc('Update enum attribute')
- ->groups(['api', 'database', 'schema'])
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].update')
- ->label('audits.event', 'attribute.update')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'attributes',
- name: 'updateEnumAttribute',
- description: '/docs/references/databases/update-enum-attribute.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_ATTRIBUTE_ENUM,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('key', '', new Key(), 'Attribute Key.')
- ->param('elements', null, new ArrayList(new Text(DATABASE::LENGTH_KEY), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Array of elements in enumerated type. Uses length of longest element to determine size. Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' elements are allowed, each ' . DATABASE::LENGTH_KEY . ' characters long.')
- ->param('required', null, new Boolean(), 'Is attribute required?')
- ->param('default', null, new Nullable(new Text(0)), 'Default value for attribute when not provided. Cannot be set when attribute is required.')
- ->param('newKey', null, new Key(), 'New attribute key.', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, string $collectionId, string $key, ?array $elements, ?bool $required, ?string $default, ?string $newKey, Response $response, Database $dbForProject, Event $queueForEvents) {
- $attribute = updateAttribute(
- databaseId: $databaseId,
- collectionId: $collectionId,
- key: $key,
- dbForProject: $dbForProject,
- queueForEvents: $queueForEvents,
- type: Database::VAR_STRING,
- filter: APP_DATABASE_ATTRIBUTE_ENUM,
- default: $default,
- required: $required,
- elements: $elements,
- newKey: $newKey
- );
-
- $response
- ->setStatusCode(Response::STATUS_CODE_OK)
- ->dynamic($attribute, Response::MODEL_ATTRIBUTE_ENUM);
- });
-
-App::patch('/v1/databases/:databaseId/collections/:collectionId/attributes/ip/:key')
- ->desc('Update IP address attribute')
- ->groups(['api', 'database', 'schema'])
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].update')
- ->label('audits.event', 'attribute.update')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'attributes',
- name: 'updateIpAttribute',
- description: '/docs/references/databases/update-ip-attribute.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_ATTRIBUTE_IP,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('key', '', new Key(), 'Attribute Key.')
- ->param('required', null, new Boolean(), 'Is attribute required?')
- ->param('default', null, new Nullable(new IP()), 'Default value for attribute when not provided. Cannot be set when attribute is required.')
- ->param('newKey', null, new Key(), 'New attribute key.', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, string $collectionId, string $key, ?bool $required, ?string $default, ?string $newKey, Response $response, Database $dbForProject, Event $queueForEvents) {
- $attribute = updateAttribute(
- databaseId: $databaseId,
- collectionId: $collectionId,
- key: $key,
- dbForProject: $dbForProject,
- queueForEvents: $queueForEvents,
- type: Database::VAR_STRING,
- filter: APP_DATABASE_ATTRIBUTE_IP,
- default: $default,
- required: $required,
- newKey: $newKey
- );
-
- $response
- ->setStatusCode(Response::STATUS_CODE_OK)
- ->dynamic($attribute, Response::MODEL_ATTRIBUTE_IP);
- });
-
-App::patch('/v1/databases/:databaseId/collections/:collectionId/attributes/url/:key')
- ->desc('Update URL attribute')
- ->groups(['api', 'database', 'schema'])
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].update')
- ->label('audits.event', 'attribute.update')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'attributes',
- name: 'updateUrlAttribute',
- description: '/docs/references/databases/update-url-attribute.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_ATTRIBUTE_URL,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('key', '', new Key(), 'Attribute Key.')
- ->param('required', null, new Boolean(), 'Is attribute required?')
- ->param('default', null, new Nullable(new URL()), 'Default value for attribute when not provided. Cannot be set when attribute is required.')
- ->param('newKey', null, new Key(), 'New attribute key.', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, string $collectionId, string $key, ?bool $required, ?string $default, ?string $newKey, Response $response, Database $dbForProject, Event $queueForEvents) {
- $attribute = updateAttribute(
- databaseId: $databaseId,
- collectionId: $collectionId,
- key: $key,
- dbForProject: $dbForProject,
- queueForEvents: $queueForEvents,
- type: Database::VAR_STRING,
- filter: APP_DATABASE_ATTRIBUTE_URL,
- default: $default,
- required: $required,
- newKey: $newKey
- );
-
- $response
- ->setStatusCode(Response::STATUS_CODE_OK)
- ->dynamic($attribute, Response::MODEL_ATTRIBUTE_URL);
- });
-
-App::patch('/v1/databases/:databaseId/collections/:collectionId/attributes/integer/:key')
- ->desc('Update integer attribute')
- ->groups(['api', 'database', 'schema'])
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].update')
- ->label('audits.event', 'attribute.update')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'attributes',
- name: 'updateIntegerAttribute',
- description: '/docs/references/databases/update-integer-attribute.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_ATTRIBUTE_INTEGER,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('key', '', new Key(), 'Attribute Key.')
- ->param('required', null, new Boolean(), 'Is attribute required?')
- ->param('min', null, new Integer(), 'Minimum value to enforce on new documents', true)
- ->param('max', null, new Integer(), 'Maximum value to enforce on new documents', true)
- ->param('default', null, new Nullable(new Integer()), 'Default value for attribute when not provided. Cannot be set when attribute is required.')
- ->param('newKey', null, new Key(), 'New attribute key.', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, string $collectionId, string $key, ?bool $required, ?int $min, ?int $max, ?int $default, ?string $newKey, Response $response, Database $dbForProject, Event $queueForEvents) {
- $attribute = updateAttribute(
- databaseId: $databaseId,
- collectionId: $collectionId,
- key: $key,
- dbForProject: $dbForProject,
- queueForEvents: $queueForEvents,
- type: Database::VAR_INTEGER,
- default: $default,
- required: $required,
- min: $min,
- max: $max,
- newKey: $newKey
- );
-
- $formatOptions = $attribute->getAttribute('formatOptions', []);
-
- if (!empty($formatOptions)) {
- $attribute->setAttribute('min', \intval($formatOptions['min']));
- $attribute->setAttribute('max', \intval($formatOptions['max']));
- }
-
- $response
- ->setStatusCode(Response::STATUS_CODE_OK)
- ->dynamic($attribute, Response::MODEL_ATTRIBUTE_INTEGER);
- });
-
-App::patch('/v1/databases/:databaseId/collections/:collectionId/attributes/float/:key')
- ->desc('Update float attribute')
- ->groups(['api', 'database', 'schema'])
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].update')
- ->label('audits.event', 'attribute.update')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'attributes',
- name: 'updateFloatAttribute',
- description: '/docs/references/databases/update-float-attribute.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_ATTRIBUTE_FLOAT,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('key', '', new Key(), 'Attribute Key.')
- ->param('required', null, new Boolean(), 'Is attribute required?')
- ->param('min', null, new FloatValidator(), 'Minimum value to enforce on new documents', true)
- ->param('max', null, new FloatValidator(), 'Maximum value to enforce on new documents', true)
- ->param('default', null, new Nullable(new FloatValidator()), 'Default value for attribute when not provided. Cannot be set when attribute is required.')
- ->param('newKey', null, new Key(), 'New attribute key.', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, string $collectionId, string $key, ?bool $required, ?float $min, ?float $max, ?float $default, ?string $newKey, Response $response, Database $dbForProject, Event $queueForEvents) {
- $attribute = updateAttribute(
- databaseId: $databaseId,
- collectionId: $collectionId,
- key: $key,
- dbForProject: $dbForProject,
- queueForEvents: $queueForEvents,
- type: Database::VAR_FLOAT,
- default: $default,
- required: $required,
- min: $min,
- max: $max,
- newKey: $newKey
- );
-
- $formatOptions = $attribute->getAttribute('formatOptions', []);
-
- if (!empty($formatOptions)) {
- $attribute->setAttribute('min', \floatval($formatOptions['min']));
- $attribute->setAttribute('max', \floatval($formatOptions['max']));
- }
-
- $response
- ->setStatusCode(Response::STATUS_CODE_OK)
- ->dynamic($attribute, Response::MODEL_ATTRIBUTE_FLOAT);
- });
-
-App::patch('/v1/databases/:databaseId/collections/:collectionId/attributes/boolean/:key')
- ->desc('Update boolean attribute')
- ->groups(['api', 'database', 'schema'])
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].update')
- ->label('audits.event', 'attribute.update')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'attributes',
- name: 'updateBooleanAttribute',
- description: '/docs/references/databases/update-boolean-attribute.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_ATTRIBUTE_BOOLEAN,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('key', '', new Key(), 'Attribute Key.')
- ->param('required', null, new Boolean(), 'Is attribute required?')
- ->param('default', null, new Nullable(new Boolean()), 'Default value for attribute when not provided. Cannot be set when attribute is required.')
- ->param('newKey', null, new Key(), 'New attribute key.', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, string $collectionId, string $key, ?bool $required, ?bool $default, ?string $newKey, Response $response, Database $dbForProject, Event $queueForEvents) {
- $attribute = updateAttribute(
- databaseId: $databaseId,
- collectionId: $collectionId,
- key: $key,
- dbForProject: $dbForProject,
- queueForEvents: $queueForEvents,
- type: Database::VAR_BOOLEAN,
- default: $default,
- required: $required,
- newKey: $newKey
- );
-
- $response
- ->setStatusCode(Response::STATUS_CODE_OK)
- ->dynamic($attribute, Response::MODEL_ATTRIBUTE_BOOLEAN);
- });
-
-App::patch('/v1/databases/:databaseId/collections/:collectionId/attributes/datetime/:key')
- ->desc('Update dateTime attribute')
- ->groups(['api', 'database', 'schema'])
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].update')
- ->label('audits.event', 'attribute.update')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'attributes',
- name: 'updateDatetimeAttribute',
- description: '/docs/references/databases/update-datetime-attribute.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_ATTRIBUTE_DATETIME,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('key', '', new Key(), 'Attribute Key.')
- ->param('required', null, new Boolean(), 'Is attribute required?')
- ->param('default', null, fn (Database $dbForProject) => new Nullable(new DatetimeValidator($dbForProject->getAdapter()->getMinDateTime(), $dbForProject->getAdapter()->getMaxDateTime())), 'Default value for attribute when not provided. Cannot be set when attribute is required.', injections: ['dbForProject'])
- ->param('newKey', null, new Key(), 'New attribute key.', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, string $collectionId, string $key, ?bool $required, ?string $default, ?string $newKey, Response $response, Database $dbForProject, Event $queueForEvents) {
- $attribute = updateAttribute(
- databaseId: $databaseId,
- collectionId: $collectionId,
- key: $key,
- dbForProject: $dbForProject,
- queueForEvents: $queueForEvents,
- type: Database::VAR_DATETIME,
- default: $default,
- required: $required,
- newKey: $newKey
- );
-
- $response
- ->setStatusCode(Response::STATUS_CODE_OK)
- ->dynamic($attribute, Response::MODEL_ATTRIBUTE_DATETIME);
- });
-
-App::patch('/v1/databases/:databaseId/collections/:collectionId/attributes/:key/relationship')
- ->desc('Update relationship attribute')
- ->groups(['api', 'database', 'schema'])
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].update')
- ->label('audits.event', 'attribute.update')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'attributes',
- name: 'updateRelationshipAttribute',
- description: '/docs/references/databases/update-relationship-attribute.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_ATTRIBUTE_RELATIONSHIP,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('key', '', new Key(), 'Attribute Key.')
- ->param('onDelete', null, new WhiteList([Database::RELATION_MUTATE_CASCADE, Database::RELATION_MUTATE_RESTRICT, Database::RELATION_MUTATE_SET_NULL], true), 'Constraints option', true)
- ->param('newKey', null, new Key(), 'New attribute key.', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForEvents')
- ->action(function (
- string $databaseId,
- string $collectionId,
- string $key,
- ?string $onDelete,
- ?string $newKey,
- Response $response,
- Database $dbForProject,
- Event $queueForEvents
- ) {
- $attribute = updateAttribute(
- $databaseId,
- $collectionId,
- $key,
- $dbForProject,
- $queueForEvents,
- type: Database::VAR_RELATIONSHIP,
- required: false,
- options: [
- 'onDelete' => $onDelete
- ],
- newKey: $newKey
- );
-
- $options = $attribute->getAttribute('options', []);
-
- foreach ($options as $key => $option) {
- $attribute->setAttribute($key, $option);
- }
-
- $response
- ->setStatusCode(Response::STATUS_CODE_OK)
- ->dynamic($attribute, Response::MODEL_ATTRIBUTE_RELATIONSHIP);
- });
-
-App::delete('/v1/databases/:databaseId/collections/:collectionId/attributes/:key')
- ->alias('/v1/database/collections/:collectionId/attributes/:key')
- ->desc('Delete attribute')
- ->groups(['api', 'database', 'schema'])
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].update')
- ->label('audits.event', 'attribute.delete')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'attributes',
- name: 'deleteAttribute',
- description: '/docs/references/databases/delete-attribute.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_NOCONTENT,
- model: Response::MODEL_NONE,
- )
- ],
- contentType: ContentType::NONE
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('key', '', new Key(), 'Attribute Key.')
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForDatabase')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, string $collectionId, string $key, Response $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents) {
- $database = $dbForProject->getDocument('databases', $databaseId);
-
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
-
- if ($collection->isEmpty()) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- $attribute = $dbForProject->getDocument('attributes', $database->getSequence() . '_' . $collection->getSequence() . '_' . $key);
-
- if ($attribute->isEmpty()) {
- throw new Exception(Exception::ATTRIBUTE_NOT_FOUND);
- }
-
- /**
- * Check index dependency
- */
- $validator = new IndexDependencyValidator(
- $collection->getAttribute('indexes'),
- $dbForProject->getAdapter()->getSupportForCastIndexArray(),
- );
-
- if (! $validator->isValid($attribute)) {
- throw new Exception(Exception::INDEX_DEPENDENCY);
- }
-
- // Only update status if removing available attribute
- if ($attribute->getAttribute('status') === 'available') {
- $attribute = $dbForProject->updateDocument('attributes', $attribute->getId(), $attribute->setAttribute('status', 'deleting'));
- }
-
- $dbForProject->purgeCachedDocument('database_' . $database->getSequence(), $collectionId);
- $dbForProject->purgeCachedCollection('database_' . $database->getSequence() . '_collection_' . $collection->getSequence());
-
- if ($attribute->getAttribute('type') === Database::VAR_RELATIONSHIP) {
- $options = $attribute->getAttribute('options');
- if ($options['twoWay']) {
- $relatedCollection = $dbForProject->getDocument('database_' . $database->getSequence(), $options['relatedCollection']);
-
- if ($relatedCollection->isEmpty()) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- $relatedAttribute = $dbForProject->getDocument('attributes', $database->getSequence() . '_' . $relatedCollection->getSequence() . '_' . $options['twoWayKey']);
-
- if ($relatedAttribute->isEmpty()) {
- throw new Exception(Exception::ATTRIBUTE_NOT_FOUND);
- }
-
- if ($relatedAttribute->getAttribute('status') === 'available') {
- $dbForProject->updateDocument('attributes', $relatedAttribute->getId(), $relatedAttribute->setAttribute('status', 'deleting'));
- }
-
- $dbForProject->purgeCachedDocument('database_' . $database->getSequence(), $options['relatedCollection']);
- $dbForProject->purgeCachedCollection('database_' . $database->getSequence() . '_collection_' . $relatedCollection->getSequence());
- }
- }
-
- $queueForDatabase
- ->setType(DATABASE_TYPE_DELETE_ATTRIBUTE)
- ->setCollection($collection)
- ->setDatabase($database)
- ->setDocument($attribute);
-
- // Select response model based on type and format
- $type = $attribute->getAttribute('type');
- $format = $attribute->getAttribute('format');
-
- $model = match ($type) {
- Database::VAR_BOOLEAN => Response::MODEL_ATTRIBUTE_BOOLEAN,
- Database::VAR_INTEGER => Response::MODEL_ATTRIBUTE_INTEGER,
- Database::VAR_FLOAT => Response::MODEL_ATTRIBUTE_FLOAT,
- Database::VAR_DATETIME => Response::MODEL_ATTRIBUTE_DATETIME,
- Database::VAR_RELATIONSHIP => Response::MODEL_ATTRIBUTE_RELATIONSHIP,
- Database::VAR_STRING => match ($format) {
- APP_DATABASE_ATTRIBUTE_EMAIL => Response::MODEL_ATTRIBUTE_EMAIL,
- APP_DATABASE_ATTRIBUTE_ENUM => Response::MODEL_ATTRIBUTE_ENUM,
- APP_DATABASE_ATTRIBUTE_IP => Response::MODEL_ATTRIBUTE_IP,
- APP_DATABASE_ATTRIBUTE_URL => Response::MODEL_ATTRIBUTE_URL,
- default => Response::MODEL_ATTRIBUTE_STRING,
- },
- default => Response::MODEL_ATTRIBUTE,
- };
-
- $queueForEvents
- ->setParam('databaseId', $databaseId)
- ->setParam('collectionId', $collection->getId())
- ->setParam('attributeId', $attribute->getId())
- ->setContext('collection', $collection)
- ->setContext('database', $database)
- ->setPayload($response->output($attribute, $model));
-
- $response->noContent();
- });
-
-App::post('/v1/databases/:databaseId/collections/:collectionId/indexes')
- ->alias('/v1/database/collections/:collectionId/indexes')
- ->desc('Create index')
- ->groups(['api', 'database'])
- ->label('event', 'databases.[databaseId].collections.[collectionId].indexes.[indexId].create')
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('audits.event', 'index.create')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'collections',
- name: 'createIndex',
- description: '/docs/references/databases/create-index.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_ACCEPTED,
- model: Response::MODEL_INDEX,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('key', null, new Key(), 'Index Key.')
- ->param('type', null, new WhiteList([Database::INDEX_KEY, Database::INDEX_FULLTEXT, Database::INDEX_UNIQUE]), 'Index type.')
- ->param('attributes', null, new ArrayList(new Key(true), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Array of attributes to index. Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' attributes are allowed, each 32 characters long.')
- ->param('orders', [], new ArrayList(new WhiteList(['ASC', 'DESC'], false, Database::VAR_STRING), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Array of index orders. Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' orders are allowed.', true)
- ->param('lengths', [], new ArrayList(new Nullable(new Integer()), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Length of index. Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE, optional: true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForDatabase')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, string $collectionId, string $key, string $type, array $attributes, array $orders, array $lengths, Response $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents) {
- $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
-
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
-
- if ($collection->isEmpty()) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- $limit = $dbForProject->getLimitForIndexes();
-
- $count = $dbForProject->count('indexes', [
- Query::equal('collectionInternalId', [$collection->getSequence()]),
- Query::equal('databaseInternalId', [$database->getSequence()])
- ], max: $limit);
-
-
- if ($count >= $limit) {
- throw new Exception(Exception::INDEX_LIMIT_EXCEEDED, 'Index limit exceeded');
- }
-
- // Convert Document array to array of attribute metadata
- $oldAttributes = \array_map(fn ($a) => $a->getArrayCopy(), $collection->getAttribute('attributes'));
-
- $oldAttributes[] = [
- 'key' => '$id',
- 'type' => Database::VAR_STRING,
- 'status' => 'available',
- 'required' => true,
- 'array' => false,
- 'default' => null,
- 'size' => Database::LENGTH_KEY
- ];
- $oldAttributes[] = [
- 'key' => '$createdAt',
- 'type' => Database::VAR_DATETIME,
- 'status' => 'available',
- 'signed' => false,
- 'required' => false,
- 'array' => false,
- 'default' => null,
- 'size' => 0
- ];
- $oldAttributes[] = [
- 'key' => '$updatedAt',
- 'type' => Database::VAR_DATETIME,
- 'status' => 'available',
- 'signed' => false,
- 'required' => false,
- 'array' => false,
- 'default' => null,
- 'size' => 0
- ];
-
- foreach ($attributes as $i => $attribute) {
- // Find attribute metadata in collection document
- $attributeIndex = \array_search($attribute, array_column($oldAttributes, 'key'));
-
- if ($attributeIndex === false) {
- throw new Exception(Exception::ATTRIBUTE_UNKNOWN, 'Unknown attribute: ' . $attribute . '. Verify the attribute name or create the attribute.');
- }
-
- $attributeStatus = $oldAttributes[$attributeIndex]['status'];
- $attributeType = $oldAttributes[$attributeIndex]['type'];
- $attributeArray = $oldAttributes[$attributeIndex]['array'] ?? false;
-
- if ($attributeType === Database::VAR_RELATIONSHIP) {
- throw new Exception(Exception::ATTRIBUTE_TYPE_INVALID, 'Cannot create an index for a relationship attribute: ' . $oldAttributes[$attributeIndex]['key']);
- }
-
- // ensure attribute is available
- if ($attributeStatus !== 'available') {
- throw new Exception(Exception::ATTRIBUTE_NOT_AVAILABLE, 'Attribute not available: ' . $oldAttributes[$attributeIndex]['key']);
- }
-
- $lengths[$i] ??= null;
- if ($attributeArray === true) {
- $lengths[$i] = Database::ARRAY_INDEX_LENGTH;
- $orders[$i] = null;
- }
- }
-
- $index = new Document([
- '$id' => ID::custom($database->getSequence() . '_' . $collection->getSequence() . '_' . $key),
- 'key' => $key,
- 'status' => 'processing', // processing, available, failed, deleting, stuck
- 'databaseInternalId' => $database->getSequence(),
- 'databaseId' => $databaseId,
- 'collectionInternalId' => $collection->getSequence(),
- 'collectionId' => $collectionId,
- 'type' => $type,
- 'attributes' => $attributes,
- 'lengths' => $lengths,
- 'orders' => $orders,
- ]);
-
- $validator = new IndexValidator(
- $collection->getAttribute('attributes'),
- $dbForProject->getAdapter()->getMaxIndexLength(),
- $dbForProject->getAdapter()->getInternalIndexesKeys(),
- );
-
- if (!$validator->isValid($index)) {
- throw new Exception(Exception::INDEX_INVALID, $validator->getDescription());
- }
-
- try {
- $index = $dbForProject->createDocument('indexes', $index);
- } catch (DuplicateException) {
- throw new Exception(Exception::INDEX_ALREADY_EXISTS);
- }
-
- $dbForProject->purgeCachedDocument('database_' . $database->getSequence(), $collectionId);
-
- $queueForDatabase
- ->setType(DATABASE_TYPE_CREATE_INDEX)
- ->setDatabase($database)
- ->setCollection($collection)
- ->setDocument($index);
-
- $queueForEvents
- ->setParam('databaseId', $databaseId)
- ->setParam('collectionId', $collection->getId())
- ->setParam('indexId', $index->getId())
- ->setContext('collection', $collection)
- ->setContext('database', $database);
-
- $response
- ->setStatusCode(Response::STATUS_CODE_ACCEPTED)
- ->dynamic($index, Response::MODEL_INDEX);
- });
-
-App::get('/v1/databases/:databaseId/collections/:collectionId/indexes')
- ->alias('/v1/database/collections/:collectionId/indexes')
- ->desc('List indexes')
- ->groups(['api', 'database'])
- ->label('scope', 'collections.read')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'indexes',
- name: 'listIndexes',
- description: '/docs/references/databases/list-indexes.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_INDEX_LIST,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('queries', [], new Indexes(), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long. You may filter on the following attributes: ' . implode(', ', Indexes::ALLOWED_ATTRIBUTES), true)
- ->inject('response')
- ->inject('dbForProject')
- ->action(function (string $databaseId, string $collectionId, array $queries, Response $response, Database $dbForProject) {
- $database = $dbForProject->getDocument('databases', $databaseId);
-
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
-
- if ($collection->isEmpty()) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- $queries = Query::parseQueries($queries);
-
- \array_push(
- $queries,
- Query::equal('databaseId', [$databaseId]),
- Query::equal('collectionId', [$collectionId]),
- );
-
- /**
- * Get cursor document if there was a cursor query, we use array_filter and reset for reference $cursor to $queries
- */
- $cursor = \array_filter($queries, function ($query) {
- return \in_array($query->getMethod(), [Query::TYPE_CURSOR_AFTER, Query::TYPE_CURSOR_BEFORE]);
- });
-
- $cursor = reset($cursor);
-
- if ($cursor) {
- $validator = new Cursor();
- if (!$validator->isValid($cursor)) {
- throw new Exception(Exception::GENERAL_QUERY_INVALID, $validator->getDescription());
- }
-
- $indexId = $cursor->getValue();
- $cursorDocument = Authorization::skip(fn () => $dbForProject->find('indexes', [
- Query::equal('collectionInternalId', [$collection->getSequence()]),
- Query::equal('databaseInternalId', [$database->getSequence()]),
- Query::equal('key', [$indexId]),
- Query::limit(1)
- ]));
-
- if (empty($cursorDocument) || $cursorDocument[0]->isEmpty()) {
- throw new Exception(Exception::GENERAL_CURSOR_NOT_FOUND, "Index '{$indexId}' for the 'cursor' value not found.");
- }
-
- $cursor->setValue($cursorDocument[0]);
- }
-
- try {
- $total = $dbForProject->count('indexes', $queries, APP_LIMIT_COUNT);
- $indexes = $dbForProject->find('indexes', $queries);
- } catch (OrderException $e) {
- throw new Exception(Exception::DATABASE_QUERY_ORDER_NULL, "The order attribute '{$e->getAttribute()}' had a null value. Cursor pagination requires all documents order attribute values are non-null.");
- } catch (QueryException $e) {
- throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
- }
-
- $response->dynamic(new Document([
- 'total' => $total,
- 'indexes' => $indexes,
- ]), Response::MODEL_INDEX_LIST);
- });
-
-App::get('/v1/databases/:databaseId/collections/:collectionId/indexes/:key')
- ->alias('/v1/database/collections/:collectionId/indexes/:key')
- ->desc('Get index')
- ->groups(['api', 'database'])
- ->label('scope', 'collections.read')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'indexes',
- name: 'getIndex',
- description: '/docs/references/databases/get-index.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_INDEX,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('key', null, new Key(), 'Index Key.')
- ->inject('response')
- ->inject('dbForProject')
- ->action(function (string $databaseId, string $collectionId, string $key, Response $response, Database $dbForProject) {
- $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
-
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
-
- if ($collection->isEmpty()) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- $index = $collection->find('key', $key, 'indexes');
-
- if (empty($index)) {
- throw new Exception(Exception::INDEX_NOT_FOUND);
- }
-
- $response->dynamic($index, Response::MODEL_INDEX);
- });
-
-App::delete('/v1/databases/:databaseId/collections/:collectionId/indexes/:key')
- ->alias('/v1/database/collections/:collectionId/indexes/:key')
- ->desc('Delete index')
- ->groups(['api', 'database'])
- ->label('scope', 'collections.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('event', 'databases.[databaseId].collections.[collectionId].indexes.[indexId].update')
- ->label('audits.event', 'index.delete')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'indexes',
- name: 'deleteIndex',
- description: '/docs/references/databases/delete-index.md',
- auth: [AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_NOCONTENT,
- model: Response::MODEL_NONE,
- )
- ],
- contentType: ContentType::NONE
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('key', '', new Key(), 'Index Key.')
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForDatabase')
- ->inject('queueForEvents')
- ->action(function (string $databaseId, string $collectionId, string $key, Response $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents) {
- $database = $dbForProject->getDocument('databases', $databaseId);
-
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
-
- if ($collection->isEmpty()) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- $index = $dbForProject->getDocument('indexes', $database->getSequence() . '_' . $collection->getSequence() . '_' . $key);
-
- if ($index->isEmpty()) {
- throw new Exception(Exception::INDEX_NOT_FOUND);
- }
-
- // Only update status if removing available index
- if ($index->getAttribute('status') === 'available') {
- $index = $dbForProject->updateDocument('indexes', $index->getId(), $index->setAttribute('status', 'deleting'));
- }
-
- $dbForProject->purgeCachedDocument('database_' . $database->getSequence(), $collectionId);
-
- $queueForDatabase
- ->setType(DATABASE_TYPE_DELETE_INDEX)
- ->setDatabase($database)
- ->setCollection($collection)
- ->setDocument($index);
-
- $queueForEvents
- ->setParam('databaseId', $databaseId)
- ->setParam('collectionId', $collection->getId())
- ->setParam('indexId', $index->getId())
- ->setContext('collection', $collection)
- ->setContext('database', $database)
- ->setPayload($response->output($index, Response::MODEL_INDEX));
-
- $response->noContent();
- });
-
-App::post('/v1/databases/:databaseId/collections/:collectionId/documents')
- ->alias('/v1/database/collections/:collectionId/documents')
- ->desc('Create document')
- ->groups(['api', 'database'])
- ->label('scope', 'documents.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('audits.event', 'document.create')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
- ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT * 2)
- ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
- ->label(
- 'sdk',
- // Using multiple methods to abstract the complexity for SDK users
- [
- new Method(
- namespace: 'databases',
- group: 'documents',
- name: 'createDocument',
- description: '/docs/references/databases/create-document.md',
- auth: [AuthType::ADMIN, AuthType::SESSION, AuthType::KEY, AuthType::JWT],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_CREATED,
- model: Response::MODEL_DOCUMENT,
- )
- ],
- contentType: ContentType::JSON,
- parameters: [
- new Parameter('databaseId', optional: false),
- new Parameter('collectionId', optional: false),
- new Parameter('documentId', optional: false),
- new Parameter('data', optional: false),
- new Parameter('permissions', optional: true),
- ]
- ),
- new Method(
- namespace: 'databases',
- group: 'documents',
- name: 'createDocuments',
- description: '/docs/references/databases/create-documents.md',
- auth: [AuthType::ADMIN, AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_CREATED,
- model: Response::MODEL_DOCUMENT_LIST,
- )
- ],
- contentType: ContentType::JSON,
- parameters: [
- new Parameter('databaseId', optional: false),
- new Parameter('collectionId', optional: false),
- new Parameter('documents', optional: false),
- ]
- )
- ]
- )
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('documentId', '', new CustomId(), 'Document ID. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can\'t start with a special char. Max length is 36 chars.', true)
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection). Make sure to define attributes before creating documents.')
- ->param('data', [], new JSON(), 'Document data as JSON object.', true)
- ->param('permissions', null, new Permissions(APP_LIMIT_ARRAY_PARAMS_SIZE, [Database::PERMISSION_READ, Database::PERMISSION_UPDATE, Database::PERMISSION_DELETE, Database::PERMISSION_WRITE]), 'An array of permissions strings. By default, only the current user is granted all permissions. [Learn more about permissions](https://appwrite.io/docs/permissions).', true)
- ->param('documents', [], fn (array $plan) => new ArrayList(new JSON(), $plan['databasesBatchSize'] ?? APP_LIMIT_DATABASE_BATCH), 'Array of documents data as JSON objects.', true, ['plan'])
- ->inject('response')
- ->inject('dbForProject')
- ->inject('user')
- ->inject('queueForEvents')
- ->inject('queueForStatsUsage')
- ->action(function (string $databaseId, ?string $documentId, string $collectionId, string|array|null $data, ?array $permissions, ?array $documents, Response $response, Database $dbForProject, Document $user, Event $queueForEvents, StatsUsage $queueForStatsUsage) {
- $data = \is_string($data)
- ? \json_decode($data, true)
- : $data;
-
- /**
- * Determine which internal path to call, single or bulk
- */
- if (empty($data) && empty($documents)) {
- // No single or bulk documents provided
- throw new Exception(Exception::DOCUMENT_MISSING_DATA);
- }
- if (!empty($data) && !empty($documents)) {
- // Both single and bulk documents provided
- throw new Exception(Exception::GENERAL_BAD_REQUEST, 'You can only send one of the following parameters: data, documents');
- }
- if (!empty($data) && empty($documentId)) {
- // Single document provided without document ID
- throw new Exception(Exception::DOCUMENT_MISSING_DATA, 'Document ID is required when creating a single document');
- }
- if (!empty($documents) && !empty($documentId)) {
- // Bulk documents provided with document ID
- throw new Exception(Exception::GENERAL_BAD_REQUEST, 'Param "documentId" is disallowed when creating multiple documents, set "$id" in each document instead');
- }
- if (!empty($documents) && !empty($permissions)) {
- // Bulk documents provided with permissions
- throw new Exception(Exception::GENERAL_BAD_REQUEST, 'Param "permissions" is disallowed when creating multiple documents, set "$permissions" in each document instead');
- }
-
- $isBulk = true;
- if (!empty($data)) {
- // Single document provided, convert to single item array
- // But remember that it was single to respond with a single document
- $isBulk = false;
- $documents = [$data];
- }
-
- $isAPIKey = Auth::isAppUser(Authorization::getRoles());
- $isPrivilegedUser = Auth::isPrivilegedUser(Authorization::getRoles());
-
- if ($isBulk && !$isAPIKey && !$isPrivilegedUser) {
- throw new Exception(Exception::GENERAL_UNAUTHORIZED_SCOPE);
- }
-
- $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
- if ($database->isEmpty() || (!$database->getAttribute('enabled', false) && !$isAPIKey && !$isPrivilegedUser)) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collection = Authorization::skip(fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId));
- if ($collection->isEmpty() || (!$collection->getAttribute('enabled', false) && !$isAPIKey && !$isPrivilegedUser)) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- $hasRelationships = \array_filter(
- $collection->getAttribute('attributes', []),
- fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
- );
-
- if ($isBulk && $hasRelationships) {
- throw new Exception(Exception::GENERAL_BAD_REQUEST, 'Bulk create is not supported for collections with relationship attributes');
- }
-
- $setPermissions = function (Document $document, ?array $permissions) use ($user, $isAPIKey, $isPrivilegedUser, $isBulk) {
- $allowedPermissions = [
- Database::PERMISSION_READ,
- Database::PERMISSION_UPDATE,
- Database::PERMISSION_DELETE,
- ];
-
- // If bulk, we need to validate permissions explicitly per document
- if ($isBulk) {
- $permissions = $document['$permissions'] ?? null;
- if (!empty($permissions)) {
- $validator = new Permissions();
- if (!$validator->isValid($permissions)) {
- throw new Exception(Exception::GENERAL_BAD_REQUEST, $validator->getDescription());
- }
- }
- }
-
- $permissions = Permission::aggregate($permissions, $allowedPermissions);
-
- // Add permissions for current the user if none were provided.
- if (\is_null($permissions)) {
- $permissions = [];
- if (!empty($user->getId())) {
- foreach ($allowedPermissions as $permission) {
- $permissions[] = (new Permission($permission, 'user', $user->getId()))->toString();
- }
- }
- }
-
- // Users can only manage their own roles, API keys and Admin users can manage any
- if (!$isAPIKey && !$isPrivilegedUser) {
- foreach (Database::PERMISSIONS as $type) {
- foreach ($permissions as $permission) {
- $permission = Permission::parse($permission);
- if ($permission->getPermission() != $type) {
- continue;
- }
- $role = (new Role(
- $permission->getRole(),
- $permission->getIdentifier(),
- $permission->getDimension()
- ))->toString();
- if (!Authorization::isRole($role)) {
- throw new Exception(Exception::USER_UNAUTHORIZED, 'Permissions must be one of: (' . \implode(', ', Authorization::getRoles()) . ')');
- }
- }
- }
- }
-
- $document->setAttribute('$permissions', $permissions);
- };
-
- $operations = 0;
-
- $checkPermissions = function (Document $collection, Document $document, string $permission) use (&$checkPermissions, $dbForProject, $database, &$operations) {
- $operations++;
-
- $documentSecurity = $collection->getAttribute('documentSecurity', false);
- $validator = new Authorization($permission);
-
- $valid = $validator->isValid($collection->getPermissionsByType($permission));
- if (($permission === Database::PERMISSION_UPDATE && !$documentSecurity) || !$valid) {
- throw new Exception(Exception::USER_UNAUTHORIZED);
- }
-
- if ($permission === Database::PERMISSION_UPDATE) {
- $valid = $valid || $validator->isValid($document->getUpdate());
- if ($documentSecurity && !$valid) {
- throw new Exception(Exception::USER_UNAUTHORIZED);
- }
- }
-
- $relationships = \array_filter(
- $collection->getAttribute('attributes', []),
- fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
- );
-
- foreach ($relationships as $relationship) {
- $related = $document->getAttribute($relationship->getAttribute('key'));
-
- if (empty($related)) {
- continue;
- }
-
- $isList = \is_array($related) && \array_values($related) === $related;
-
- if ($isList) {
- $relations = $related;
- } else {
- $relations = [$related];
- }
-
- $relatedCollectionId = $relationship->getAttribute('relatedCollection');
- $relatedCollection = Authorization::skip(
- fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $relatedCollectionId)
- );
-
- foreach ($relations as &$relation) {
- if (
- \is_array($relation)
- && \array_values($relation) !== $relation
- && !isset($relation['$id'])
- ) {
- $relation['$id'] = ID::unique();
- $relation = new Document($relation);
- }
- if ($relation instanceof Document) {
- $current = Authorization::skip(
- fn () => $dbForProject->getDocument('database_' . $database->getSequence() . '_collection_' . $relatedCollection->getSequence(), $relation->getId())
- );
-
- if ($current->isEmpty()) {
- $type = Database::PERMISSION_CREATE;
-
- if (isset($relation['$id']) && $relation['$id'] === 'unique()') {
- $relation['$id'] = ID::unique();
- }
- } else {
- $relation->removeAttribute('$collectionId');
- $relation->removeAttribute('$databaseId');
- $relation->setAttribute('$collection', $relatedCollection->getId());
- $type = Database::PERMISSION_UPDATE;
- }
-
- $checkPermissions($relatedCollection, $relation, $type);
- }
- }
-
- if ($isList) {
- $document->setAttribute($relationship->getAttribute('key'), \array_values($relations));
- } else {
- $document->setAttribute($relationship->getAttribute('key'), \reset($relations));
- }
- }
- };
-
- $documents = \array_map(function ($document) use ($collection, $permissions, $checkPermissions, $isBulk, $documentId, $setPermissions) {
- $document['$collection'] = $collection->getId();
-
- // Determine the source ID depending on whether it's a bulk operation.
- $sourceId = $isBulk
- ? ($document['$id'] ?? ID::unique())
- : $documentId;
-
- // If bulk, we need to validate ID explicitly
- if ($isBulk) {
- $validator = new CustomId();
- if (!$validator->isValid($sourceId)) {
- throw new Exception(Exception::GENERAL_BAD_REQUEST, $validator->getDescription());
- }
- }
-
- // Assign a unique ID if needed, otherwise use the provided ID.
- $document['$id'] = $sourceId === 'unique()' ? ID::unique() : $sourceId;
- $document = new Document($document);
- $setPermissions($document, $permissions);
- $checkPermissions($collection, $document, Database::PERMISSION_CREATE);
-
- return $document;
- }, $documents);
-
- try {
- $dbForProject->createDocuments(
- 'database_' . $database->getSequence() . '_collection_' . $collection->getSequence(),
- $documents
- );
- } catch (DuplicateException) {
- throw new Exception(Exception::DOCUMENT_ALREADY_EXISTS);
- } catch (NotFoundException) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- } catch (RelationshipException $e) {
- throw new Exception(Exception::RELATIONSHIP_VALUE_INVALID, $e->getMessage());
- } catch (StructureException $e) {
- throw new Exception(Exception::DOCUMENT_INVALID_STRUCTURE, $e->getMessage());
- }
-
- $queueForEvents
- ->setParam('databaseId', $databaseId)
- ->setParam('collectionId', $collection->getId())
- ->setContext('collection', $collection)
- ->setContext('database', $database);
-
- // Add $collectionId and $databaseId for all documents
- $processDocument = function (Document $collection, Document $document) use (&$processDocument, $dbForProject, $database) {
- $document->removeAttribute('$collection');
- $document->setAttribute('$databaseId', $database->getId());
- $document->setAttribute('$collectionId', $collection->getId());
-
- $relationships = \array_filter(
- $collection->getAttribute('attributes', []),
- fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
- );
-
- foreach ($relationships as $relationship) {
- $related = $document->getAttribute($relationship->getAttribute('key'));
-
- if (empty($related)) {
- continue;
- }
- if (!\is_array($related)) {
- $related = [$related];
- }
-
- $relatedCollectionId = $relationship->getAttribute('relatedCollection');
- $relatedCollection = Authorization::skip(
- fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $relatedCollectionId)
- );
-
- foreach ($related as $relation) {
- if ($relation instanceof Document) {
- $processDocument($relatedCollection, $relation);
- }
- }
- }
- };
-
- foreach ($documents as $document) {
- $processDocument($collection, $document);
- }
-
- $queueForStatsUsage
- ->addMetric(METRIC_DATABASES_OPERATIONS_WRITES, \max(1, $operations))
- ->addMetric(str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_OPERATIONS_WRITES), \max(1, $operations)); // per collection
-
- $response->setStatusCode(Response::STATUS_CODE_CREATED);
-
- if ($isBulk) {
- $response->dynamic(new Document([
- 'total' => count($documents),
- 'documents' => $documents
- ]), Response::MODEL_DOCUMENT_LIST);
-
- return;
- }
-
- $queueForEvents
- ->setParam('documentId', $documents[0]->getId())
- ->setEvent('databases.[databaseId].collections.[collectionId].documents.[documentId].create');
-
- $response->dynamic(
- $documents[0],
- Response::MODEL_DOCUMENT
- );
- });
-
-App::get('/v1/databases/:databaseId/collections/:collectionId/documents')
- ->alias('/v1/database/collections/:collectionId/documents')
- ->desc('List documents')
- ->groups(['api', 'database'])
- ->label('scope', 'documents.read')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'documents',
- name: 'listDocuments',
- description: '/docs/references/databases/list-documents.md',
- auth: [AuthType::SESSION, AuthType::KEY, AuthType::JWT],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_DOCUMENT_LIST,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('queries', [], new ArrayList(new Text(APP_LIMIT_ARRAY_ELEMENT_SIZE), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long.', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForStatsUsage')
- ->action(function (string $databaseId, string $collectionId, array $queries, Response $response, Database $dbForProject, StatsUsage $queueForStatsUsage) {
- $isAPIKey = Auth::isAppUser(Authorization::getRoles());
- $isPrivilegedUser = Auth::isPrivilegedUser(Authorization::getRoles());
-
- $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
- if ($database->isEmpty() || (!$database->getAttribute('enabled', false) && !$isAPIKey && !$isPrivilegedUser)) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collection = Authorization::skip(fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId));
- if ($collection->isEmpty() || (!$collection->getAttribute('enabled', false) && !$isAPIKey && !$isPrivilegedUser)) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- try {
- $queries = Query::parseQueries($queries);
- } catch (QueryException $e) {
- throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
- }
-
- /**
- * Get cursor document if there was a cursor query, we use array_filter and reset for reference $cursor to $queries
- */
- $cursor = \array_filter($queries, function ($query) {
- return \in_array($query->getMethod(), [Query::TYPE_CURSOR_AFTER, Query::TYPE_CURSOR_BEFORE]);
- });
-
- $cursor = \reset($cursor);
-
- if ($cursor) {
- $validator = new Cursor();
- if (!$validator->isValid($cursor)) {
- throw new Exception(Exception::GENERAL_QUERY_INVALID, $validator->getDescription());
- }
-
- $documentId = $cursor->getValue();
-
- $cursorDocument = Authorization::skip(fn () => $dbForProject->getDocument('database_' . $database->getSequence() . '_collection_' . $collection->getSequence(), $documentId));
-
- if ($cursorDocument->isEmpty()) {
- throw new Exception(Exception::GENERAL_CURSOR_NOT_FOUND, "Document '{$documentId}' for the 'cursor' value not found.");
- }
-
- $cursor->setValue($cursorDocument);
- }
-
- $selectQueries = [];
-
- try {
- $selectQueries = Query::groupByType($queries)['selections'] ?? [];
-
- if (! empty($selectQueries)) {
- // has selects, allow relationship on documents!
- $documents = $dbForProject->find('database_' . $database->getSequence() . '_collection_' . $collection->getSequence(), $queries);
- } else {
- // has no selects, disable relationship looping on documents!
- $documents = $dbForProject->skipRelationships(fn () => $dbForProject->find('database_' . $database->getSequence() . '_collection_' . $collection->getSequence(), $queries));
- }
-
- $total = $dbForProject->count('database_' . $database->getSequence() . '_collection_' . $collection->getSequence(), $queries, APP_LIMIT_COUNT);
- } catch (OrderException $e) {
- throw new Exception(Exception::DATABASE_QUERY_ORDER_NULL, "The order attribute '{$e->getAttribute()}' had a null value. Cursor pagination requires all documents order attribute values are non-null.");
- } catch (QueryException $e) {
- throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
- }
-
- $operations = 0;
-
- // Add $collectionId and $databaseId for all documents
- $processDocument = (function (Document $collection, Document $document) use (&$processDocument, $dbForProject, $database, &$operations): bool {
- if ($document->isEmpty()) {
- return false;
- }
-
- $operations++;
-
- $document->setAttribute('$databaseId', $database->getId());
- $document->setAttribute('$collectionId', $collection->getId());
-
- $relationships = \array_filter(
- $collection->getAttribute('attributes', []),
- fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
- );
-
- foreach ($relationships as $relationship) {
- $related = $document->getAttribute($relationship->getAttribute('key'));
-
- if (empty($related)) {
- if (\in_array(\gettype($related), ['array', 'object'])) {
- $operations++;
- }
-
- continue;
- }
-
- if (!\is_array($related)) {
- $relations = [$related];
- } else {
- $relations = $related;
- }
-
- $relatedCollectionId = $relationship->getAttribute('relatedCollection');
- // todo: Use local cache for this getDocument
- $relatedCollection = Authorization::skip(fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $relatedCollectionId));
-
- foreach ($relations as $index => $doc) {
- if ($doc instanceof Document) {
- if (!$processDocument($relatedCollection, $doc)) {
- unset($relations[$index]);
- }
- }
- }
-
- if (\is_array($related)) {
- $document->setAttribute($relationship->getAttribute('key'), \array_values($relations));
- } elseif (empty($relations)) {
- $document->setAttribute($relationship->getAttribute('key'), null);
- }
- }
-
- return true;
- });
-
- foreach ($documents as $document) {
- $processDocument($collection, $document);
- }
-
- $queueForStatsUsage
- ->addMetric(METRIC_DATABASES_OPERATIONS_READS, \max(1, $operations))
- ->addMetric(str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_OPERATIONS_READS), \max(1, $operations));
-
- // Check if the SELECT query includes $databaseId and $collectionId
- $hasWildcard = false;
- $hasDatabaseId = false;
- $hasCollectionId = false;
- $hasSelectQueries = !empty($selectQueries);
-
- if ($hasSelectQueries) {
- foreach ($selectQueries as $query) {
- if ($query->getMethod() !== Query::TYPE_SELECT) {
- continue;
- }
-
- $values = $query->getValues();
- if (\in_array('*', $values, true)) {
- $hasWildcard = true;
- break;
- }
-
- if (\in_array('$databaseId', $values, true)) {
- $hasDatabaseId = true;
- }
-
- if (\in_array('$collectionId', $values, true)) {
- $hasCollectionId = true;
- }
- }
-
- if (!$hasWildcard) {
- foreach ($documents as $document) {
- if (!$hasDatabaseId) {
- $document->removeAttribute('$databaseId');
- }
- if (!$hasCollectionId) {
- $document->removeAttribute('$collectionId');
- }
- }
- }
- }
-
- $response->dynamic(new Document([
- 'total' => $total,
- 'documents' => $documents,
- ]), Response::MODEL_DOCUMENT_LIST);
- });
-
-App::get('/v1/databases/:databaseId/collections/:collectionId/documents/:documentId')
- ->alias('/v1/database/collections/:collectionId/documents/:documentId')
- ->desc('Get document')
- ->groups(['api', 'database'])
- ->label('scope', 'documents.read')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'documents',
- name: 'getDocument',
- description: '/docs/references/databases/get-document.md',
- auth: [AuthType::SESSION, AuthType::KEY, AuthType::JWT],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_DOCUMENT,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('documentId', '', new UID(), 'Document ID.')
- ->param('queries', [], new ArrayList(new Text(APP_LIMIT_ARRAY_ELEMENT_SIZE), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long.', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForStatsUsage')
- ->action(function (string $databaseId, string $collectionId, string $documentId, array $queries, Response $response, Database $dbForProject, StatsUsage $queueForStatsUsage) {
- $isAPIKey = Auth::isAppUser(Authorization::getRoles());
- $isPrivilegedUser = Auth::isPrivilegedUser(Authorization::getRoles());
-
- $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
- if ($database->isEmpty() || (!$database->getAttribute('enabled', false) && !$isAPIKey && !$isPrivilegedUser)) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collection = Authorization::skip(fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId));
- if ($collection->isEmpty() || (!$collection->getAttribute('enabled', false) && !$isAPIKey && !$isPrivilegedUser)) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- try {
- $queries = Query::parseQueries($queries);
- } catch (QueryException $e) {
- throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
- }
-
- $selects = Query::groupByType($queries)['selections'] ?? [];
-
- if (! empty($selects)) {
- // has selects, allow relationship on documents!
- $document = $dbForProject->getDocument('database_' . $database->getSequence() . '_collection_' . $collection->getSequence(), $documentId, $queries);
- } else {
- // has no selects, disable relationship looping on documents!
- $document = $dbForProject->skipRelationships(fn () => $dbForProject->getDocument('database_' . $database->getSequence() . '_collection_' . $collection->getSequence(), $documentId, $queries));
- }
-
- if ($document->isEmpty()) {
- throw new Exception(Exception::DOCUMENT_NOT_FOUND);
- }
-
- $operations = 0;
-
- // Add $collectionId and $databaseId for all documents
- $processDocument = function (Document $collection, Document $document) use (&$processDocument, $dbForProject, $database, &$operations) {
- if ($document->isEmpty()) {
- return;
- }
-
- $operations++;
-
- $document->setAttribute('$databaseId', $database->getId());
- $document->setAttribute('$collectionId', $collection->getId());
-
- $relationships = \array_filter(
- $collection->getAttribute('attributes', []),
- fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
- );
-
- foreach ($relationships as $relationship) {
- $related = $document->getAttribute($relationship->getAttribute('key'));
-
- if (empty($related)) {
- if (\in_array(\gettype($related), ['array', 'object'])) {
- $operations++;
- }
-
- continue;
- }
-
- if (!\is_array($related)) {
- $related = [$related];
- }
-
- $relatedCollectionId = $relationship->getAttribute('relatedCollection');
- $relatedCollection = Authorization::skip(
- fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $relatedCollectionId)
- );
-
- foreach ($related as $relation) {
- if ($relation instanceof Document) {
- $processDocument($relatedCollection, $relation);
- }
- }
- }
- };
-
- $processDocument($collection, $document);
-
- $queueForStatsUsage
- ->addMetric(METRIC_DATABASES_OPERATIONS_READS, \max(1, $operations))
- ->addMetric(str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_OPERATIONS_READS), \max(1, $operations));
-
- $response->dynamic($document, Response::MODEL_DOCUMENT);
- });
-
-App::get('/v1/databases/:databaseId/collections/:collectionId/documents/:documentId/logs')
- ->alias('/v1/database/collections/:collectionId/documents/:documentId/logs')
- ->desc('List document logs')
- ->groups(['api', 'database'])
- ->label('scope', 'documents.read')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'logs',
- name: 'listDocumentLogs',
- description: '/docs/references/databases/get-document-logs.md',
- auth: [AuthType::ADMIN],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_LOG_LIST,
- )
- ],
- contentType: ContentType::JSON,
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID.')
- ->param('documentId', '', new UID(), 'Document ID.')
- ->param('queries', [], new Queries([new Limit(), new Offset()]), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Only supported methods are limit and offset', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('locale')
- ->inject('geodb')
- ->action(function (string $databaseId, string $collectionId, string $documentId, array $queries, Response $response, Database $dbForProject, Locale $locale, Reader $geodb) {
- $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
- if ($collection->isEmpty()) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- $document = $dbForProject->getDocument('database_' . $database->getSequence() . '_collection_' . $collection->getSequence(), $documentId);
-
- if ($document->isEmpty()) {
- throw new Exception(Exception::DOCUMENT_NOT_FOUND);
- }
-
- try {
- $queries = Query::parseQueries($queries);
- } catch (QueryException $e) {
- throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
- }
-
- // Temp fix for logs
- $queries[] = Query::or([
- Query::greaterThan('$createdAt', DateTime::format(new \DateTime('2025-02-26T01:30+00:00'))),
- Query::lessThan('$createdAt', DateTime::format(new \DateTime('2025-02-13T00:00+00:00'))),
- ]);
-
- $audit = new Audit($dbForProject);
- $resource = 'database/' . $databaseId . '/collection/' . $collectionId . '/document/' . $document->getId();
- $logs = $audit->getLogsByResource($resource, $queries);
-
- $output = [];
-
- foreach ($logs as $i => &$log) {
- $log['userAgent'] = (!empty($log['userAgent'])) ? $log['userAgent'] : 'UNKNOWN';
-
- $detector = new Detector($log['userAgent']);
- $detector->skipBotDetection(); // OPTIONAL: If called, bot detection will completely be skipped (bots will be detected as regular devices then)
-
- $os = $detector->getOS();
- $client = $detector->getClient();
- $device = $detector->getDevice();
-
- $output[$i] = new Document([
- 'event' => $log['event'],
- 'userId' => $log['data']['userId'],
- 'userEmail' => $log['data']['userEmail'] ?? null,
- 'userName' => $log['data']['userName'] ?? null,
- 'mode' => $log['data']['mode'] ?? null,
- 'ip' => $log['ip'],
- 'time' => $log['time'],
- 'osCode' => $os['osCode'],
- 'osName' => $os['osName'],
- 'osVersion' => $os['osVersion'],
- 'clientType' => $client['clientType'],
- 'clientCode' => $client['clientCode'],
- 'clientName' => $client['clientName'],
- 'clientVersion' => $client['clientVersion'],
- 'clientEngine' => $client['clientEngine'],
- 'clientEngineVersion' => $client['clientEngineVersion'],
- 'deviceName' => $device['deviceName'],
- 'deviceBrand' => $device['deviceBrand'],
- 'deviceModel' => $device['deviceModel']
- ]);
-
- $record = $geodb->get($log['ip']);
-
- if ($record) {
- $output[$i]['countryCode'] = $locale->getText('countries.' . strtolower($record['country']['iso_code']), false) ? \strtolower($record['country']['iso_code']) : '--';
- $output[$i]['countryName'] = $locale->getText('countries.' . strtolower($record['country']['iso_code']), $locale->getText('locale.country.unknown'));
- } else {
- $output[$i]['countryCode'] = '--';
- $output[$i]['countryName'] = $locale->getText('locale.country.unknown');
- }
- }
-
- $response->dynamic(new Document([
- 'total' => $audit->countLogsByResource($resource, $queries),
- 'logs' => $output,
- ]), Response::MODEL_LOG_LIST);
- });
-
-App::patch('/v1/databases/:databaseId/collections/:collectionId/documents/:documentId')
- ->alias('/v1/database/collections/:collectionId/documents/:documentId')
- ->desc('Update document')
- ->groups(['api', 'database'])
- ->label('event', 'databases.[databaseId].collections.[collectionId].documents.[documentId].update')
- ->label('scope', 'documents.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('audits.event', 'document.update')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}/document/{response.$id}')
- ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
- ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT * 2)
- ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'documents',
- name: 'updateDocument',
- description: '/docs/references/databases/update-document.md',
- auth: [AuthType::SESSION, AuthType::KEY, AuthType::JWT],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_DOCUMENT,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID.')
- ->param('documentId', '', new UID(), 'Document ID.')
- ->param('data', [], new JSON(), 'Document data as JSON object. Include only attribute and value pairs to be updated.', true)
- ->param('permissions', null, new Permissions(APP_LIMIT_ARRAY_PARAMS_SIZE, [Database::PERMISSION_READ, Database::PERMISSION_UPDATE, Database::PERMISSION_DELETE, Database::PERMISSION_WRITE]), 'An array of permissions strings. By default, the current permissions are inherited. [Learn more about permissions](https://appwrite.io/docs/permissions).', true)
- ->inject('requestTimestamp')
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForEvents')
- ->inject('queueForStatsUsage')
- ->action(function (string $databaseId, string $collectionId, string $documentId, string|array $data, ?array $permissions, ?\DateTime $requestTimestamp, Response $response, Database $dbForProject, Event $queueForEvents, StatsUsage $queueForStatsUsage) {
- $data = (\is_string($data)) ? \json_decode($data, true) : $data; // Cast to JSON array
-
- if (empty($data) && \is_null($permissions)) {
- throw new Exception(Exception::DOCUMENT_MISSING_PAYLOAD);
- }
-
- $isAPIKey = Auth::isAppUser(Authorization::getRoles());
- $isPrivilegedUser = Auth::isPrivilegedUser(Authorization::getRoles());
-
- $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
- if ($database->isEmpty() || (!$database->getAttribute('enabled', false) && !$isAPIKey && !$isPrivilegedUser)) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collection = Authorization::skip(fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId));
- if ($collection->isEmpty() || (!$collection->getAttribute('enabled', false) && !$isAPIKey && !$isPrivilegedUser)) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- // Read permission should not be required for update
- $document = Authorization::skip(fn () => $dbForProject->getDocument('database_' . $database->getSequence() . '_collection_' . $collection->getSequence(), $documentId));
- if ($document->isEmpty()) {
- throw new Exception(Exception::DOCUMENT_NOT_FOUND);
- }
-
- // Map aggregate permissions into the multiple permissions they represent.
- $permissions = Permission::aggregate($permissions, [
- Database::PERMISSION_READ,
- Database::PERMISSION_UPDATE,
- Database::PERMISSION_DELETE,
- ]);
-
- // Users can only manage their own roles, API keys and Admin users can manage any
- $roles = Authorization::getRoles();
- if (!$isAPIKey && !$isPrivilegedUser && !\is_null($permissions)) {
- foreach (Database::PERMISSIONS as $type) {
- foreach ($permissions as $permission) {
- $permission = Permission::parse($permission);
- if ($permission->getPermission() != $type) {
- continue;
- }
- $role = (new Role(
- $permission->getRole(),
- $permission->getIdentifier(),
- $permission->getDimension()
- ))->toString();
- if (!Authorization::isRole($role)) {
- throw new Exception(Exception::USER_UNAUTHORIZED, 'Permissions must be one of: (' . \implode(', ', $roles) . ')');
- }
- }
- }
- }
-
- if (\is_null($permissions)) {
- $permissions = $document->getPermissions() ?? [];
- }
-
- $data['$id'] = $documentId;
- $data['$permissions'] = $permissions;
- $newDocument = new Document($data);
-
- $operations = 0;
-
- $setCollection = (function (Document $collection, Document $document) use (&$setCollection, $dbForProject, $database, &$operations) {
-
- $operations++;
-
- $relationships = \array_filter(
- $collection->getAttribute('attributes', []),
- fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
- );
-
- foreach ($relationships as $relationship) {
- $related = $document->getAttribute($relationship->getAttribute('key'));
-
- if (empty($related)) {
- continue;
- }
-
- $isList = \is_array($related) && \array_values($related) === $related;
-
- if ($isList) {
- $relations = $related;
- } else {
- $relations = [$related];
- }
-
- $relatedCollectionId = $relationship->getAttribute('relatedCollection');
- $relatedCollection = Authorization::skip(
- fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $relatedCollectionId)
- );
-
- foreach ($relations as &$relation) {
- // If the relation is an array it can be either update or create a child document.
- if (
- \is_array($relation)
- && \array_values($relation) !== $relation
- && !isset($relation['$id'])
- ) {
- $relation['$id'] = ID::unique();
- $relation = new Document($relation);
- }
- if ($relation instanceof Document) {
- $oldDocument = Authorization::skip(fn () => $dbForProject->getDocument(
- 'database_' . $database->getSequence() . '_collection_' . $relatedCollection->getSequence(),
- $relation->getId()
- ));
- $relation->removeAttribute('$collectionId');
- $relation->removeAttribute('$databaseId');
- // Attribute $collection is required for Utopia.
- $relation->setAttribute(
- '$collection',
- 'database_' . $database->getSequence() . '_collection_' . $relatedCollection->getSequence()
- );
-
- if ($oldDocument->isEmpty()) {
- if (isset($relation['$id']) && $relation['$id'] === 'unique()') {
- $relation['$id'] = ID::unique();
- }
- }
- $setCollection($relatedCollection, $relation);
- }
- }
-
- if ($isList) {
- $document->setAttribute($relationship->getAttribute('key'), \array_values($relations));
- } else {
- $document->setAttribute($relationship->getAttribute('key'), \reset($relations));
- }
- }
- });
-
- $setCollection($collection, $newDocument);
-
- $queueForStatsUsage
- ->addMetric(METRIC_DATABASES_OPERATIONS_WRITES, \max(1, $operations))
- ->addMetric(str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_OPERATIONS_WRITES), \max(1, $operations));
-
- try {
- $document = $dbForProject->updateDocument(
- 'database_' . $database->getSequence() . '_collection_' . $collection->getSequence(),
- $document->getId(),
- $newDocument
- );
- } catch (ConflictException) {
- throw new Exception(Exception::DOCUMENT_UPDATE_CONFLICT);
- } catch (DuplicateException) {
- throw new Exception(Exception::DOCUMENT_ALREADY_EXISTS);
- } catch (RelationshipException $e) {
- throw new Exception(Exception::RELATIONSHIP_VALUE_INVALID, $e->getMessage());
- } catch (StructureException $e) {
- throw new Exception(Exception::DOCUMENT_INVALID_STRUCTURE, $e->getMessage());
- }
-
- // Add $collectionId and $databaseId for all documents
- $processDocument = function (Document $collection, Document $document) use (&$processDocument, $dbForProject, $database) {
- $document->setAttribute('$databaseId', $database->getId());
- $document->setAttribute('$collectionId', $collection->getId());
-
- $relationships = \array_filter(
- $collection->getAttribute('attributes', []),
- fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
- );
-
- foreach ($relationships as $relationship) {
- $related = $document->getAttribute($relationship->getAttribute('key'));
-
- if (empty($related)) {
- continue;
- }
- if (!\is_array($related)) {
- $related = [$related];
- }
-
- $relatedCollectionId = $relationship->getAttribute('relatedCollection');
- $relatedCollection = Authorization::skip(
- fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $relatedCollectionId)
- );
-
- foreach ($related as $relation) {
- if ($relation instanceof Document) {
- $processDocument($relatedCollection, $relation);
- }
- }
- }
- };
-
- $processDocument($collection, $document);
-
- $relationships = \array_map(
- fn ($document) => $document->getAttribute('key'),
- \array_filter(
- $collection->getAttribute('attributes', []),
- fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
- )
- );
-
- $queueForEvents
- ->setParam('databaseId', $databaseId)
- ->setParam('collectionId', $collection->getId())
- ->setParam('documentId', $document->getId())
- ->setContext('collection', $collection)
- ->setContext('database', $database)
- ->setPayload($response->getPayload(), sensitive: $relationships);
-
- $response->dynamic($document, Response::MODEL_DOCUMENT);
- });
-
-App::put('/v1/databases/:databaseId/collections/:collectionId/documents/:documentId')
- ->desc('Upsert document')
- ->groups(['api', 'database'])
- ->label('event', 'databases.[databaseId].collections.[collectionId].documents.[documentId].upsert')
- ->label('scope', 'documents.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('audits.event', 'document.upsert')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}/document/{response.$id}')
- ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
- ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT * 2)
- ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'documents',
- name: 'upsertDocument',
- description: '/docs/references/databases/upsert-document.md',
- auth: [AuthType::SESSION, AuthType::KEY, AuthType::JWT],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_DOCUMENT,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID.')
- ->param('documentId', '', new CustomId(), 'Document ID.')
- ->param('data', [], new JSON(), 'Document data as JSON object. Include all required attributes of the document to be created or updated.')
- ->param('permissions', null, new Permissions(APP_LIMIT_ARRAY_PARAMS_SIZE, [Database::PERMISSION_READ, Database::PERMISSION_UPDATE, Database::PERMISSION_DELETE, Database::PERMISSION_WRITE]), 'An array of permissions strings. By default, the current permissions are inherited. [Learn more about permissions](https://appwrite.io/docs/permissions).', true)
- ->inject('requestTimestamp')
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForEvents')
- ->inject('queueForStatsUsage')
- ->action(function (string $databaseId, string $collectionId, string $documentId, string|array $data, ?array $permissions, ?\DateTime $requestTimestamp, Response $response, Database $dbForProject, Event $queueForEvents, StatsUsage $queueForStatsUsage) {
- $data = (\is_string($data)) ? \json_decode($data, true) : $data; // Cast to JSON array
-
- if (empty($data) && \is_null($permissions)) {
- throw new Exception(Exception::DOCUMENT_MISSING_PAYLOAD);
- }
-
- $isAPIKey = Auth::isAppUser(Authorization::getRoles());
- $isPrivilegedUser = Auth::isPrivilegedUser(Authorization::getRoles());
-
- $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
- if ($database->isEmpty() || (!$database->getAttribute('enabled', false) && !$isAPIKey && !$isPrivilegedUser)) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collection = Authorization::skip(fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId));
- if ($collection->isEmpty() || (!$collection->getAttribute('enabled', false) && !$isAPIKey && !$isPrivilegedUser)) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- // Map aggregate permissions into the multiple permissions they represent.
- $permissions = Permission::aggregate($permissions, [
- Database::PERMISSION_READ,
- Database::PERMISSION_UPDATE,
- Database::PERMISSION_DELETE,
- ]);
-
- // Users can only manage their own roles, API keys and Admin users can manage any
- $roles = Authorization::getRoles();
- if (!$isAPIKey && !$isPrivilegedUser && !\is_null($permissions)) {
- foreach (Database::PERMISSIONS as $type) {
- foreach ($permissions as $permission) {
- $permission = Permission::parse($permission);
- if ($permission->getPermission() != $type) {
- continue;
- }
- $role = (new Role(
- $permission->getRole(),
- $permission->getIdentifier(),
- $permission->getDimension()
- ))->toString();
- if (!Authorization::isRole($role)) {
- throw new Exception(Exception::USER_UNAUTHORIZED, 'Permissions must be one of: (' . \implode(', ', $roles) . ')');
- }
- }
- }
- }
-
- $data['$id'] = $documentId;
- $data['$permissions'] = $permissions;
- $newDocument = new Document($data);
-
- $operations = 0;
-
- $setCollection = (function (Document $collection, Document $document) use (&$setCollection, $dbForProject, $database, &$operations) {
-
- $operations++;
-
- $relationships = \array_filter(
- $collection->getAttribute('attributes', []),
- fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
- );
-
- foreach ($relationships as $relationship) {
- $related = $document->getAttribute($relationship->getAttribute('key'));
-
- if (empty($related)) {
- continue;
- }
-
- $isList = \is_array($related) && \array_values($related) === $related;
-
- if ($isList) {
- $relations = $related;
- } else {
- $relations = [$related];
- }
-
- $relatedCollectionId = $relationship->getAttribute('relatedCollection');
- $relatedCollection = Authorization::skip(
- fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $relatedCollectionId)
- );
-
- foreach ($relations as &$relation) {
- // If the relation is an array it can be either update or create a child document.
- if (
- \is_array($relation)
- && \array_values($relation) !== $relation
- && !isset($relation['$id'])
- ) {
- $relation['$id'] = ID::unique();
- $relation = new Document($relation);
- }
- if ($relation instanceof Document) {
- $oldDocument = Authorization::skip(fn () => $dbForProject->getDocument(
- 'database_' . $database->getSequence() . '_collection_' . $relatedCollection->getSequence(),
- $relation->getId()
- ));
- $relation->removeAttribute('$collectionId');
- $relation->removeAttribute('$databaseId');
- // Attribute $collection is required for Utopia.
- $relation->setAttribute(
- '$collection',
- 'database_' . $database->getSequence() . '_collection_' . $relatedCollection->getSequence()
- );
-
- if ($oldDocument->isEmpty()) {
- if (isset($relation['$id']) && $relation['$id'] === 'unique()') {
- $relation['$id'] = ID::unique();
- }
- }
- $setCollection($relatedCollection, $relation);
- }
- }
-
- if ($isList) {
- $document->setAttribute($relationship->getAttribute('key'), \array_values($relations));
- } else {
- $document->setAttribute($relationship->getAttribute('key'), \reset($relations));
- }
- }
- });
-
- $setCollection($collection, $newDocument);
-
- $queueForStatsUsage
- ->addMetric(METRIC_DATABASES_OPERATIONS_WRITES, \max(1, $operations))
- ->addMetric(str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_OPERATIONS_WRITES), \max(1, $operations));
-
- $upserted = [];
- try {
- $modified = $dbForProject->createOrUpdateDocuments(
- 'database_' . $database->getSequence() . '_collection_' . $collection->getSequence(),
- [$newDocument],
- onNext: function (Document $document) use (&$upserted) {
- $upserted[] = $document;
- },
- );
- } catch (ConflictException) {
- throw new Exception(Exception::DOCUMENT_UPDATE_CONFLICT);
- } catch (DuplicateException) {
- throw new Exception(Exception::DOCUMENT_ALREADY_EXISTS);
- } catch (RelationshipException $e) {
- throw new Exception(Exception::RELATIONSHIP_VALUE_INVALID, $e->getMessage());
- } catch (StructureException $e) {
- throw new Exception(Exception::DOCUMENT_INVALID_STRUCTURE, $e->getMessage());
- }
-
- $document = $upserted[0];
- // Add $collectionId and $databaseId for all documents
- $processDocument = function (Document $collection, Document $document) use (&$processDocument, $dbForProject, $database) {
- $document->setAttribute('$databaseId', $database->getId());
- $document->setAttribute('$collectionId', $collection->getId());
-
- $relationships = \array_filter(
- $collection->getAttribute('attributes', []),
- fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
- );
-
- foreach ($relationships as $relationship) {
- $related = $document->getAttribute($relationship->getAttribute('key'));
-
- if (empty($related)) {
- continue;
- }
- if (!\is_array($related)) {
- $related = [$related];
- }
-
- $relatedCollectionId = $relationship->getAttribute('relatedCollection');
- $relatedCollection = Authorization::skip(
- fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $relatedCollectionId)
- );
-
- foreach ($related as $relation) {
- if ($relation instanceof Document) {
- $processDocument($relatedCollection, $relation);
- }
- }
- }
- };
-
- $processDocument($collection, $document);
-
- $relationships = \array_map(
- fn ($document) => $document->getAttribute('key'),
- \array_filter(
- $collection->getAttribute('attributes', []),
- fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
- )
- );
-
- $queueForEvents
- ->setParam('databaseId', $databaseId)
- ->setParam('collectionId', $collection->getId())
- ->setParam('documentId', $document->getId())
- ->setContext('collection', $collection)
- ->setContext('database', $database)
- ->setPayload($response->getPayload(), sensitive: $relationships);
-
- $response->dynamic($document, Response::MODEL_DOCUMENT);
- });
-
-App::patch('/v1/databases/:databaseId/collections/:collectionId/documents/:documentId/:attribute/increment')
- ->desc('Increment document attribute')
- ->groups(['api', 'database'])
- ->label('event', 'databases.[databaseId].collections.[collectionId].documents.[documentId].increment')
- ->label('scope', 'documents.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('audits.event', 'documents.increment')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
- ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT * 2)
- ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'documents',
- name: 'incrementDocumentAttribute',
- description: '/docs/references/databases/increment-document-attribute.md',
- auth: [AuthType::ADMIN, AuthType::KEY, AuthType::SESSION, AuthType::JWT],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_DOCUMENT,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID.')
- ->param('documentId', '', new UID(), 'Document ID.')
- ->param('attribute', '', new Key(), 'Attribute key.')
- ->param('value', 1, new Numeric(), 'Value to increment the attribute by. The value must be a number.', true)
- ->param('max', null, new Numeric(), 'Maximum value for the attribute. If the current value is greater than this value, an error will be thrown.', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForEvents')
- ->inject('queueForStatsUsage')
- ->action(function (string $databaseId, string $collectionId, string $documentId, string $attribute, int|float $value, int|float|null $max, Response $response, Database $dbForProject, Event $queueForEvents, StatsUsage $queueForStatsUsage) {
- $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collection = Authorization::skip(fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId));
- if ($collection->isEmpty()) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- try {
- $document = $dbForProject->increaseDocumentAttribute(
- collection: 'database_' . $database->getSequence() . '_collection_' . $collection->getSequence(),
- id: $documentId,
- attribute: $attribute,
- value: $value,
- max: $max
- );
- } catch (ConflictException) {
- throw new Exception(Exception::DOCUMENT_UPDATE_CONFLICT);
- } catch (NotFoundException) {
- throw new Exception(Exception::ATTRIBUTE_NOT_FOUND);
- } catch (LimitException) {
- throw new Exception(Exception::ATTRIBUTE_LIMIT_EXCEEDED, 'Attribute "' . $attribute . '" has reached the maximum value of ' . $max);
- } catch (TypeException) {
- throw new Exception(Exception::ATTRIBUTE_TYPE_INVALID, 'Attribute "' . $attribute . '" is not a number');
- }
-
- $queueForStatsUsage
- ->addMetric(METRIC_DATABASES_OPERATIONS_WRITES, 1)
- ->addMetric(str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_OPERATIONS_WRITES), 1);
-
- $queueForEvents
- ->setParam('databaseId', $databaseId)
- ->setParam('collectionId', $collectionId)
- ->setContext('collection', $collection)
- ->setContext('database', $database);
-
- $response->dynamic($document, Response::MODEL_DOCUMENT);
- });
-
-App::patch('/v1/databases/:databaseId/collections/:collectionId/documents/:documentId/:attribute/decrement')
- ->desc('Decrement document attribute')
- ->groups(['api', 'database'])
- ->label('event', 'databases.[databaseId].collections.[collectionId].documents.[documentId].decrement')
- ->label('scope', 'documents.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('audits.event', 'documents.decrement')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
- ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT * 2)
- ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'documents',
- name: 'decrementDocumentAttribute',
- description: '/docs/references/databases/decrement-document-attribute.md',
- auth: [AuthType::ADMIN, AuthType::KEY, AuthType::SESSION, AuthType::JWT],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_DOCUMENT,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID.')
- ->param('documentId', '', new UID(), 'Document ID.')
- ->param('attribute', '', new Key(), 'Attribute key.')
- ->param('value', 1, new Numeric(), 'Value to decrement the attribute by. The value must be a number.', true)
- ->param('min', null, new Numeric(), 'Minimum value for the attribute. If the current value is lesser than this value, an exception will be thrown.', true)
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForEvents')
- ->inject('queueForStatsUsage')
- ->action(function (string $databaseId, string $collectionId, string $documentId, string $attribute, int|float $value, int|float|null $min, Response $response, Database $dbForProject, Event $queueForEvents, StatsUsage $queueForStatsUsage) {
- $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collection = Authorization::skip(fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId));
- if ($collection->isEmpty()) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- try {
- $document = $dbForProject->decreaseDocumentAttribute(
- collection: 'database_' . $database->getSequence() . '_collection_' . $collection->getSequence(),
- id: $documentId,
- attribute: $attribute,
- value: $value,
- min: $min
- );
- } catch (ConflictException) {
- throw new Exception(Exception::DOCUMENT_UPDATE_CONFLICT);
- } catch (NotFoundException) {
- throw new Exception(Exception::ATTRIBUTE_NOT_FOUND);
- } catch (LimitException) {
- throw new Exception(Exception::ATTRIBUTE_LIMIT_EXCEEDED, 'Attribute "' . $attribute . '" has reached the minimum value of ' . $min);
- } catch (TypeException) {
- throw new Exception(Exception::ATTRIBUTE_TYPE_INVALID, 'Attribute "' . $attribute . '" is not a number');
- }
-
- $queueForStatsUsage
- ->addMetric(METRIC_DATABASES_OPERATIONS_WRITES, 1)
- ->addMetric(str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_OPERATIONS_WRITES), 1);
-
- $queueForEvents
- ->setParam('databaseId', $databaseId)
- ->setParam('collectionId', $collectionId)
- ->setContext('collection', $collection)
- ->setContext('database', $database);
-
- $response->dynamic($document, Response::MODEL_DOCUMENT);
- });
-
-App::patch('/v1/databases/:databaseId/collections/:collectionId/documents')
- ->desc('Update documents')
- ->groups(['api', 'database'])
- ->label('scope', 'documents.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('audits.event', 'documents.update')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
- ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT * 2)
- ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'documents',
- name: 'updateDocuments',
- description: '/docs/references/databases/update-documents.md',
- auth: [AuthType::ADMIN, AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_DOCUMENT_LIST,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID.')
- ->param('data', [], new JSON(), 'Document data as JSON object. Include only attribute and value pairs to be updated.', true)
- ->param('queries', [], new ArrayList(new Text(APP_LIMIT_ARRAY_ELEMENT_SIZE), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long.', true)
- ->inject('requestTimestamp')
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForStatsUsage')
- ->inject('plan')
- ->action(function (string $databaseId, string $collectionId, string|array $data, array $queries, ?\DateTime $requestTimestamp, Response $response, Database $dbForProject, StatsUsage $queueForStatsUsage, array $plan) {
- $data = \is_string($data)
- ? \json_decode($data, true)
- : $data;
-
- if (empty($data)) {
- throw new Exception(Exception::DOCUMENT_MISSING_PAYLOAD);
- }
-
- $database = $dbForProject->getDocument('databases', $databaseId);
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
- if ($collection->isEmpty()) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- $hasRelationships = \array_filter(
- $collection->getAttribute('attributes', []),
- fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
- );
-
- if ($hasRelationships) {
- throw new Exception(Exception::GENERAL_BAD_REQUEST, 'Bulk update is not supported for collections with relationship attributes');
- }
-
- try {
- $queries = Query::parseQueries($queries);
- } catch (QueryException $e) {
- throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
- }
-
- if ($data['$permissions']) {
- $validator = new Permissions();
- if (!$validator->isValid($data['$permissions'])) {
- throw new Exception(Exception::GENERAL_BAD_REQUEST, $validator->getDescription());
- }
- }
-
- $documents = [];
-
- try {
- $modified = $dbForProject->updateDocuments(
- 'database_' . $database->getSequence() . '_collection_' . $collection->getSequence(),
- new Document($data),
- $queries,
- onNext: function (Document $document) use ($plan, &$documents) {
- if (\count($documents) < ($plan['databasesBatchSize'] ?? APP_LIMIT_DATABASE_BATCH)) {
- $documents[] = $document;
- }
- },
- );
- } catch (ConflictException) {
- throw new Exception(Exception::DOCUMENT_UPDATE_CONFLICT);
- } catch (RelationshipException $e) {
- throw new Exception(Exception::RELATIONSHIP_VALUE_INVALID, $e->getMessage());
- } catch (StructureException $e) {
- throw new Exception(Exception::DOCUMENT_INVALID_STRUCTURE, $e->getMessage());
- }
-
- foreach ($documents as $document) {
- $document->setAttribute('$databaseId', $database->getId());
- $document->setAttribute('$collectionId', $collection->getId());
- }
-
- $queueForStatsUsage
- ->addMetric(METRIC_DATABASES_OPERATIONS_WRITES, \max(1, $modified))
- ->addMetric(str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_OPERATIONS_WRITES), \max(1, $modified));
-
- $response->dynamic(new Document([
- 'total' => $modified,
- 'documents' => $documents
- ]), Response::MODEL_DOCUMENT_LIST);
- });
-
-App::put('/v1/databases/:databaseId/collections/:collectionId/documents')
- ->desc('Create or update documents')
- ->groups(['api', 'database'])
- ->label('scope', 'documents.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('audits.event', 'documents.upsert')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
- ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT * 2)
- ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'documents',
- name: 'upsertDocuments',
- description: '/docs/references/databases/upsert-documents.md',
- auth: [AuthType::ADMIN, AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_DOCUMENT_LIST,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID.')
- ->param('documents', [], fn (array $plan) => new ArrayList(new JSON(), $plan['databasesBatchSize'] ?? APP_LIMIT_DATABASE_BATCH), 'Array of document data as JSON objects. May contain partial documents.', false, ['plan'])
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForStatsUsage')
- ->inject('plan')
- ->action(function (string $databaseId, string $collectionId, array $documents, Response $response, Database $dbForProject, StatsUsage $queueForStatsUsage, array $plan) {
- $database = $dbForProject->getDocument('databases', $databaseId);
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
- if ($collection->isEmpty()) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- $hasRelationships = \array_filter(
- $collection->getAttribute('attributes', []),
- fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
- );
-
- if ($hasRelationships) {
- throw new Exception(Exception::GENERAL_BAD_REQUEST, 'Bulk upsert is not supported for collections with relationship attributes');
- }
-
- foreach ($documents as $key => $document) {
- $documents[$key] = new Document($document);
- }
-
- $upserted = [];
-
- try {
- $modified = $dbForProject->createOrUpdateDocuments(
- 'database_' . $database->getSequence() . '_collection_' . $collection->getSequence(),
- $documents,
- onNext: function (Document $document) use ($plan, &$upserted) {
- if (\count($upserted) < ($plan['databasesBatchSize'] ?? APP_LIMIT_DATABASE_BATCH)) {
- $upserted[] = $document;
- }
- },
- );
- } catch (ConflictException) {
- throw new Exception(Exception::DOCUMENT_UPDATE_CONFLICT);
- } catch (DuplicateException) {
- throw new Exception(Exception::DOCUMENT_ALREADY_EXISTS);
- } catch (RelationshipException $e) {
- throw new Exception(Exception::RELATIONSHIP_VALUE_INVALID, $e->getMessage());
- } catch (StructureException $e) {
- throw new Exception(Exception::DOCUMENT_INVALID_STRUCTURE, $e->getMessage());
- }
-
- foreach ($upserted as $document) {
- $document->setAttribute('$databaseId', $database->getId());
- $document->setAttribute('$collectionId', $collection->getId());
- }
-
- $queueForStatsUsage
- ->addMetric(METRIC_DATABASES_OPERATIONS_WRITES, \max(1, $modified))
- ->addMetric(str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_OPERATIONS_WRITES), \max(1, $modified));
-
- $response->dynamic(new Document([
- 'total' => $modified,
- 'documents' => $upserted
- ]), Response::MODEL_DOCUMENT_LIST);
- });
-
-App::delete('/v1/databases/:databaseId/collections/:collectionId/documents/:documentId')
- ->alias('/v1/database/collections/:collectionId/documents/:documentId')
- ->desc('Delete document')
- ->groups(['api', 'database'])
- ->label('scope', 'documents.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('event', 'databases.[databaseId].collections.[collectionId].documents.[documentId].delete')
- ->label('audits.event', 'document.delete')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}/document/{request.documentId}')
- ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
- ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT)
- ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'documents',
- name: 'deleteDocument',
- description: '/docs/references/databases/delete-document.md',
- auth: [AuthType::SESSION, AuthType::KEY, AuthType::JWT],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_NOCONTENT,
- model: Response::MODEL_NONE,
- )
- ],
- contentType: ContentType::NONE
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('documentId', '', new UID(), 'Document ID.')
- ->inject('requestTimestamp')
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForEvents')
- ->inject('queueForStatsUsage')
- ->action(function (string $databaseId, string $collectionId, string $documentId, ?\DateTime $requestTimestamp, Response $response, Database $dbForProject, Event $queueForEvents, StatsUsage $queueForStatsUsage) {
- $isAPIKey = Auth::isAppUser(Authorization::getRoles());
- $isPrivilegedUser = Auth::isPrivilegedUser(Authorization::getRoles());
-
- $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
- if ($database->isEmpty() || (!$database->getAttribute('enabled', false) && !$isAPIKey && !$isPrivilegedUser)) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collection = Authorization::skip(fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId));
- if ($collection->isEmpty() || (!$collection->getAttribute('enabled', false) && !$isAPIKey && !$isPrivilegedUser)) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- // Read permission should not be required for delete
- $document = Authorization::skip(fn () => $dbForProject->getDocument('database_' . $database->getSequence() . '_collection_' . $collection->getSequence(), $documentId));
- if ($document->isEmpty()) {
- throw new Exception(Exception::DOCUMENT_NOT_FOUND);
- }
-
- try {
- $dbForProject->deleteDocument(
- 'database_' . $database->getSequence() . '_collection_' . $collection->getSequence(),
- $documentId
- );
- } catch (ConflictException) {
- throw new Exception(Exception::DOCUMENT_UPDATE_CONFLICT);
- } catch (RestrictedException) {
- throw new Exception(Exception::DOCUMENT_DELETE_RESTRICTED);
- }
-
- $operations = 0;
-
- // Add $collectionId and $databaseId for all documents
- $processDocument = function (Document $collection, Document $document) use (&$processDocument, $dbForProject, $database, &$operations) {
- $operations++;
-
- $document->setAttribute('$databaseId', $database->getId());
- $document->setAttribute('$collectionId', $collection->getId());
-
- $relationships = \array_filter(
- $collection->getAttribute('attributes', []),
- fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
- );
-
- foreach ($relationships as $relationship) {
- $related = $document->getAttribute($relationship->getAttribute('key'));
-
- if (empty($related)) {
- continue;
- }
- if (!\is_array($related)) {
- $related = [$related];
- }
-
- $relatedCollectionId = $relationship->getAttribute('relatedCollection');
- $relatedCollection = Authorization::skip(
- fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $relatedCollectionId)
- );
-
- foreach ($related as $relation) {
- if ($relation instanceof Document) {
- $processDocument($relatedCollection, $relation);
- }
- }
- }
- };
-
- $processDocument($collection, $document);
-
- $queueForStatsUsage
- ->addMetric(METRIC_DATABASES_OPERATIONS_WRITES, \max(1, $operations))
- ->addMetric(str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_OPERATIONS_WRITES), \max(1, $operations));
-
- $relationships = \array_map(
- fn ($document) => $document->getAttribute('key'),
- \array_filter(
- $collection->getAttribute('attributes', []),
- fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
- )
- );
-
- $queueForEvents
- ->setParam('databaseId', $databaseId)
- ->setParam('collectionId', $collection->getId())
- ->setParam('documentId', $document->getId())
- ->setContext('collection', $collection)
- ->setContext('database', $database)
- ->setPayload($response->output($document, Response::MODEL_DOCUMENT), sensitive: $relationships);
-
- $response->noContent();
- });
-
-App::delete('/v1/databases/:databaseId/collections/:collectionId/documents')
- ->desc('Delete documents')
- ->groups(['api', 'database'])
- ->label('scope', 'documents.write')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('audits.event', 'documents.delete')
- ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
- ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
- ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT)
- ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
- ->label('sdk', new Method(
- namespace: 'databases',
- group: 'documents',
- name: 'deleteDocuments',
- description: '/docs/references/databases/delete-documents.md',
- auth: [AuthType::ADMIN, AuthType::KEY],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_DOCUMENT_LIST,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
- ->param('queries', [], new ArrayList(new Text(APP_LIMIT_ARRAY_ELEMENT_SIZE), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long.', true)
- ->inject('requestTimestamp')
- ->inject('response')
- ->inject('dbForProject')
- ->inject('queueForStatsUsage')
- ->inject('plan')
- ->action(function (string $databaseId, string $collectionId, array $queries, ?\DateTime $requestTimestamp, Response $response, Database $dbForProject, StatsUsage $queueForStatsUsage, array $plan) {
- $database = $dbForProject->getDocument('databases', $databaseId);
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
- if ($collection->isEmpty()) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- $hasRelationships = \array_filter(
- $collection->getAttribute('attributes', []),
- fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
- );
-
- if ($hasRelationships) {
- throw new Exception(Exception::GENERAL_BAD_REQUEST, 'Bulk delete is not supported for collections with relationship attributes');
- }
-
- try {
- $queries = Query::parseQueries($queries);
- } catch (QueryException $e) {
- throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
- }
-
- $documents = [];
-
- try {
- $modified = $dbForProject->deleteDocuments(
- 'database_' . $database->getSequence() . '_collection_' . $collection->getSequence(),
- $queries,
- onNext: function (Document $document) use ($plan, &$documents) {
- if (\count($documents) < ($plan['databasesBatchSize'] ?? APP_LIMIT_DATABASE_BATCH)) {
- $documents[] = $document;
- }
- },
- );
- } catch (ConflictException) {
- throw new Exception(Exception::DOCUMENT_UPDATE_CONFLICT);
- } catch (RestrictedException) {
- throw new Exception(Exception::DOCUMENT_DELETE_RESTRICTED);
- }
-
- foreach ($documents as $document) {
- $document->setAttribute('$databaseId', $database->getId());
- $document->setAttribute('$collectionId', $collection->getId());
- }
-
- $queueForStatsUsage
- ->addMetric(METRIC_DATABASES_OPERATIONS_WRITES, \max(1, $modified))
- ->addMetric(str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_OPERATIONS_WRITES), \max(1, $modified));
-
- $response->dynamic(new Document([
- 'total' => $modified,
- 'documents' => $documents,
- ]), Response::MODEL_DOCUMENT_LIST);
- });
-
-App::get('/v1/databases/usage')
- ->desc('Get databases usage stats')
- ->groups(['api', 'database', 'usage'])
- ->label('scope', 'collections.read')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('sdk', new Method(
- namespace: 'databases',
- group: null,
- name: 'getUsage',
- description: '/docs/references/databases/get-usage.md',
- auth: [AuthType::ADMIN],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_USAGE_DATABASES,
- )
- ],
- contentType: ContentType::JSON
- ))
- ->param('range', '30d', new WhiteList(['24h', '30d', '90d'], true), '`Date range.', true)
- ->inject('response')
- ->inject('dbForProject')
- ->action(function (string $range, Response $response, Database $dbForProject) {
- $periods = Config::getParam('usage', []);
- $stats = $usage = [];
- $days = $periods[$range];
- $metrics = [
- METRIC_DATABASES,
- METRIC_COLLECTIONS,
- METRIC_DOCUMENTS,
- METRIC_DATABASES_STORAGE,
- METRIC_DATABASES_OPERATIONS_READS,
- METRIC_DATABASES_OPERATIONS_WRITES,
- ];
-
- Authorization::skip(function () use ($dbForProject, $days, $metrics, &$stats) {
- foreach ($metrics as $metric) {
- $result = $dbForProject->findOne('stats', [
- Query::equal('metric', [$metric]),
- Query::equal('period', ['inf'])
- ]);
-
- $stats[$metric]['total'] = $result['value'] ?? 0;
- $limit = $days['limit'];
- $period = $days['period'];
- $results = $dbForProject->find('stats', [
- Query::equal('metric', [$metric]),
- Query::equal('period', [$period]),
- Query::limit($limit),
- Query::orderDesc('time'),
- ]);
- $stats[$metric]['data'] = [];
- foreach ($results as $result) {
- $stats[$metric]['data'][$result->getAttribute('time')] = [
- 'value' => $result->getAttribute('value'),
- ];
- }
- }
- });
-
- $format = match ($days['period']) {
- '1h' => 'Y-m-d\TH:00:00.000P',
- '1d' => 'Y-m-d\T00:00:00.000P',
- };
-
- foreach ($metrics as $metric) {
- $usage[$metric]['total'] = $stats[$metric]['total'];
- $usage[$metric]['data'] = [];
- $leap = time() - ($days['limit'] * $days['factor']);
- while ($leap < time()) {
- $leap += $days['factor'];
- $formatDate = date($format, $leap);
- $usage[$metric]['data'][] = [
- 'value' => $stats[$metric]['data'][$formatDate]['value'] ?? 0,
- 'date' => $formatDate,
- ];
- }
- }
- $response->dynamic(new Document([
- 'range' => $range,
- 'databasesTotal' => $usage[$metrics[0]]['total'],
- 'collectionsTotal' => $usage[$metrics[1]]['total'],
- 'documentsTotal' => $usage[$metrics[2]]['total'],
- 'storageTotal' => $usage[$metrics[3]]['total'],
- 'databasesReadsTotal' => $usage[$metrics[4]]['total'],
- 'databasesWritesTotal' => $usage[$metrics[5]]['total'],
- 'databases' => $usage[$metrics[0]]['data'],
- 'collections' => $usage[$metrics[1]]['data'],
- 'documents' => $usage[$metrics[2]]['data'],
- 'storage' => $usage[$metrics[3]]['data'],
- 'databasesReads' => $usage[$metrics[4]]['data'],
- 'databasesWrites' => $usage[$metrics[5]]['data'],
- ]), Response::MODEL_USAGE_DATABASES);
- });
-
-App::get('/v1/databases/:databaseId/usage')
- ->desc('Get database usage stats')
- ->groups(['api', 'database', 'usage'])
- ->label('scope', 'collections.read')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('sdk', new Method(
- namespace: 'databases',
- group: null,
- name: 'getDatabaseUsage',
- description: '/docs/references/databases/get-database-usage.md',
- auth: [AuthType::ADMIN],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_USAGE_DATABASE,
- )
- ],
- contentType: ContentType::JSON,
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('range', '30d', new WhiteList(['24h', '30d', '90d'], true), '`Date range.', true)
- ->inject('response')
- ->inject('dbForProject')
- ->action(function (string $databaseId, string $range, Response $response, Database $dbForProject) {
- $database = $dbForProject->getDocument('databases', $databaseId);
- if ($database->isEmpty()) {
- throw new Exception(Exception::DATABASE_NOT_FOUND);
- }
-
- $periods = Config::getParam('usage', []);
- $stats = $usage = [];
- $days = $periods[$range];
- $metrics = [
- str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_COLLECTIONS),
- str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_DOCUMENTS),
- str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_STORAGE),
- str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_OPERATIONS_READS),
- str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_OPERATIONS_WRITES)
- ];
-
- Authorization::skip(function () use ($dbForProject, $days, $metrics, &$stats) {
- foreach ($metrics as $metric) {
- $result = $dbForProject->findOne('stats', [
- Query::equal('metric', [$metric]),
- Query::equal('period', ['inf'])
- ]);
-
- $stats[$metric]['total'] = $result['value'] ?? 0;
- $limit = $days['limit'];
- $period = $days['period'];
- $results = $dbForProject->find('stats', [
- Query::equal('metric', [$metric]),
- Query::equal('period', [$period]),
- Query::limit($limit),
- Query::orderDesc('time'),
- ]);
- $stats[$metric]['data'] = [];
- foreach ($results as $result) {
- $stats[$metric]['data'][$result->getAttribute('time')] = [
- 'value' => $result->getAttribute('value'),
- ];
- }
- }
- });
-
- $format = match ($days['period']) {
- '1h' => 'Y-m-d\TH:00:00.000P',
- '1d' => 'Y-m-d\T00:00:00.000P',
- };
-
- foreach ($metrics as $metric) {
- $usage[$metric]['total'] = $stats[$metric]['total'];
- $usage[$metric]['data'] = [];
- $leap = time() - ($days['limit'] * $days['factor']);
- while ($leap < time()) {
- $leap += $days['factor'];
- $formatDate = date($format, $leap);
- $usage[$metric]['data'][] = [
- 'value' => $stats[$metric]['data'][$formatDate]['value'] ?? 0,
- 'date' => $formatDate,
- ];
- }
- }
-
- $response->dynamic(new Document([
- 'range' => $range,
- 'collectionsTotal' => $usage[$metrics[0]]['total'],
- 'documentsTotal' => $usage[$metrics[1]]['total'],
- 'storageTotal' => $usage[$metrics[2]]['total'],
- 'databaseReadsTotal' => $usage[$metrics[3]]['total'],
- 'databaseWritesTotal' => $usage[$metrics[4]]['total'],
- 'collections' => $usage[$metrics[0]]['data'],
- 'documents' => $usage[$metrics[1]]['data'],
- 'storage' => $usage[$metrics[2]]['data'],
- 'databaseReads' => $usage[$metrics[3]]['data'],
- 'databaseWrites' => $usage[$metrics[4]]['data'],
- ]), Response::MODEL_USAGE_DATABASE);
- });
-
-App::get('/v1/databases/:databaseId/collections/:collectionId/usage')
- ->alias('/v1/database/:collectionId/usage')
- ->desc('Get collection usage stats')
- ->groups(['api', 'database', 'usage'])
- ->label('scope', 'collections.read')
- ->label('resourceType', RESOURCE_TYPE_DATABASES)
- ->label('sdk', new Method(
- namespace: 'databases',
- group: null,
- name: 'getCollectionUsage',
- description: '/docs/references/databases/get-collection-usage.md',
- auth: [AuthType::ADMIN],
- responses: [
- new SDKResponse(
- code: Response::STATUS_CODE_OK,
- model: Response::MODEL_USAGE_COLLECTION,
- )
- ],
- contentType: ContentType::JSON,
- ))
- ->param('databaseId', '', new UID(), 'Database ID.')
- ->param('range', '30d', new WhiteList(['24h', '30d', '90d'], true), 'Date range.', true)
- ->param('collectionId', '', new UID(), 'Collection ID.')
- ->inject('response')
- ->inject('dbForProject')
- ->action(function (string $databaseId, string $range, string $collectionId, Response $response, Database $dbForProject) {
- $database = $dbForProject->getDocument('databases', $databaseId);
- $collectionDocument = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
- $collection = $dbForProject->getCollection('database_' . $database->getSequence() . '_collection_' . $collectionDocument->getSequence());
-
- if ($collection->isEmpty()) {
- throw new Exception(Exception::COLLECTION_NOT_FOUND);
- }
-
- $periods = Config::getParam('usage', []);
- $stats = $usage = [];
- $days = $periods[$range];
- $metrics = [
- str_replace(['{databaseInternalId}', '{collectionInternalId}'], [$database->getSequence(), $collectionDocument->getSequence()], METRIC_DATABASE_ID_COLLECTION_ID_DOCUMENTS),
- ];
-
- Authorization::skip(function () use ($dbForProject, $days, $metrics, &$stats) {
- foreach ($metrics as $metric) {
- $result = $dbForProject->findOne('stats', [
- Query::equal('metric', [$metric]),
- Query::equal('period', ['inf'])
- ]);
-
- $stats[$metric]['total'] = $result['value'] ?? 0;
- $limit = $days['limit'];
- $period = $days['period'];
- $results = $dbForProject->find('stats', [
- Query::equal('metric', [$metric]),
- Query::equal('period', [$period]),
- Query::limit($limit),
- Query::orderDesc('time'),
- ]);
- $stats[$metric]['data'] = [];
- foreach ($results as $result) {
- $stats[$metric]['data'][$result->getAttribute('time')] = [
- 'value' => $result->getAttribute('value'),
- ];
- }
- }
- });
-
- $format = match ($days['period']) {
- '1h' => 'Y-m-d\TH:00:00.000P',
- '1d' => 'Y-m-d\T00:00:00.000P',
- };
-
- foreach ($metrics as $metric) {
- $usage[$metric]['total'] = $stats[$metric]['total'];
- $usage[$metric]['data'] = [];
- $leap = time() - ($days['limit'] * $days['factor']);
- while ($leap < time()) {
- $leap += $days['factor'];
- $formatDate = date($format, $leap);
- $usage[$metric]['data'][] = [
- 'value' => $stats[$metric]['data'][$formatDate]['value'] ?? 0,
- 'date' => $formatDate,
- ];
- }
- }
-
- $response->dynamic(new Document([
- 'range' => $range,
- 'documentsTotal' => $usage[$metrics[0]]['total'],
- 'documents' => $usage[$metrics[0]]['data'],
- ]), Response::MODEL_USAGE_COLLECTION);
- });
diff --git a/app/controllers/api/health.php b/app/controllers/api/health.php
index 2bdaea3c2c..43368b8d3f 100644
--- a/app/controllers/api/health.php
+++ b/app/controllers/api/health.php
@@ -523,11 +523,16 @@ App::get('/v1/health/queue/databases')
->param('name', 'database_db_main', new Text(256), 'Queue name for which to check the queue size', true)
->param('threshold', 5000, new Integer(true), 'Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.', true)
->inject('publisher')
+ ->inject('publisherRedis')
->inject('response')
- ->action(function (string $name, int|string $threshold, Publisher $publisher, Response $response) {
+ ->action(function (string $name, int|string $threshold, Publisher $publisher, ?Publisher $publisherRedis, Response $response) {
$threshold = \intval($threshold);
- $size = $publisher->getQueueSize(new Queue($name));
+ $isRedisFallback = \str_contains(System::getEnv('_APP_WORKER_REDIS_FALLBACK', ''), 'databases');
+
+ $size = $isRedisFallback
+ ? $publisherRedis->getQueueSize(new Queue($name))
+ : $publisher->getQueueSize(new Queue($name));
if ($size >= $threshold) {
throw new Exception(Exception::HEALTH_QUEUE_SIZE_EXCEEDED, "Queue size threshold hit. Current size is {$size} and threshold is {$threshold}.");
@@ -655,11 +660,16 @@ App::get('/v1/health/queue/migrations')
))
->param('threshold', 5000, new Integer(true), 'Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.', true)
->inject('publisher')
+ ->inject('publisherRedis')
->inject('response')
- ->action(function (int|string $threshold, Publisher $publisher, Response $response) {
+ ->action(function (int|string $threshold, Publisher $publisher, ?Publisher $publisherRedis, Response $response) {
$threshold = \intval($threshold);
- $size = $publisher->getQueueSize(new Queue(Event::MIGRATIONS_QUEUE_NAME));
+ $isRedisFallback = \str_contains(System::getEnv('_APP_WORKER_REDIS_FALLBACK', ''), 'migrations');
+
+ $size = $isRedisFallback
+ ? $publisherRedis->getQueueSize(new Queue(Event::MIGRATIONS_QUEUE_NAME))
+ : $publisher->getQueueSize(new Queue(Event::MIGRATIONS_QUEUE_NAME));
if ($size >= $threshold) {
throw new Exception(Exception::HEALTH_QUEUE_SIZE_EXCEEDED, "Queue size threshold hit. Current size is {$size} and threshold is {$threshold}.");
diff --git a/app/controllers/api/migrations.php b/app/controllers/api/migrations.php
index 92fca88744..85751811ba 100644
--- a/app/controllers/api/migrations.php
+++ b/app/controllers/api/migrations.php
@@ -361,7 +361,7 @@ App::post('/v1/migrations/csv')
$hasCompression = $compression !== Compression::NONE;
$migrationId = ID::unique();
- $newPath = $deviceForImports->getPath('/' . $migrationId . '_' . $fileId . '.csv');
+ $newPath = $deviceForImports->getPath($migrationId . '_' . $fileId . '.csv');
if ($hasEncryption || $hasCompression) {
$source = $deviceForFiles->read($path);
@@ -410,8 +410,8 @@ App::post('/v1/migrations/csv')
'resources' => $resources,
'resourceId' => $resourceId,
'resourceType' => Resource::TYPE_DATABASE,
- 'statusCounters' => [],
- 'resourceData' => [],
+ 'statusCounters' => '{}',
+ 'resourceData' => '{}',
'errors' => [],
'options' => [
'path' => $newPath,
diff --git a/app/controllers/api/project.php b/app/controllers/api/project.php
index d09470ff39..390e88637a 100644
--- a/app/controllers/api/project.php
+++ b/app/controllers/api/project.php
@@ -354,6 +354,7 @@ App::get('/v1/project/usage')
'executionsMbSecondsTotal' => $total[METRIC_EXECUTIONS_MB_SECONDS],
'buildsMbSecondsTotal' => $total[METRIC_BUILDS_MB_SECONDS],
'documentsTotal' => $total[METRIC_DOCUMENTS],
+ 'rowsTotal' => $total[METRIC_DOCUMENTS],
'databasesTotal' => $total[METRIC_DATABASES],
'databasesStorageTotal' => $total[METRIC_DATABASES_STORAGE],
'usersTotal' => $total[METRIC_USERS],
diff --git a/app/controllers/api/projects.php b/app/controllers/api/projects.php
index 5527a6bd18..34ed85a418 100644
--- a/app/controllers/api/projects.php
+++ b/app/controllers/api/projects.php
@@ -8,8 +8,8 @@ use Appwrite\Event\Mail;
use Appwrite\Event\Validator\Event;
use Appwrite\Extend\Exception;
use Appwrite\Hooks\Hooks;
+use Appwrite\Network\Platform;
use Appwrite\Network\Validator\Email;
-use Appwrite\Network\Validator\Origin;
use Appwrite\SDK\AuthType;
use Appwrite\SDK\ContentType;
use Appwrite\SDK\Method;
@@ -1791,7 +1791,7 @@ App::post('/v1/projects/:projectId/platforms')
]
))
->param('projectId', '', new UID(), 'Project unique ID.')
- ->param('type', null, new WhiteList([Origin::CLIENT_TYPE_WEB, Origin::CLIENT_TYPE_FLUTTER_WEB, Origin::CLIENT_TYPE_FLUTTER_IOS, Origin::CLIENT_TYPE_FLUTTER_ANDROID, Origin::CLIENT_TYPE_FLUTTER_LINUX, Origin::CLIENT_TYPE_FLUTTER_MACOS, Origin::CLIENT_TYPE_FLUTTER_WINDOWS, Origin::CLIENT_TYPE_APPLE_IOS, Origin::CLIENT_TYPE_APPLE_MACOS, Origin::CLIENT_TYPE_APPLE_WATCHOS, Origin::CLIENT_TYPE_APPLE_TVOS, Origin::CLIENT_TYPE_ANDROID, Origin::CLIENT_TYPE_UNITY, Origin::CLIENT_TYPE_REACT_NATIVE_IOS, Origin::CLIENT_TYPE_REACT_NATIVE_ANDROID], true), 'Platform type.')
+ ->param('type', null, new WhiteList([Platform::TYPE_WEB, Platform::TYPE_FLUTTER_WEB, Platform::TYPE_FLUTTER_IOS, Platform::TYPE_FLUTTER_ANDROID, Platform::TYPE_FLUTTER_LINUX, Platform::TYPE_FLUTTER_MACOS, Platform::TYPE_FLUTTER_WINDOWS, Platform::TYPE_APPLE_IOS, Platform::TYPE_APPLE_MACOS, Platform::TYPE_APPLE_WATCHOS, Platform::TYPE_APPLE_TVOS, Platform::TYPE_ANDROID, Platform::TYPE_UNITY, Platform::TYPE_REACT_NATIVE_IOS, Platform::TYPE_REACT_NATIVE_ANDROID], true), 'Platform type.')
->param('name', null, new Text(128), 'Platform name. Max length: 128 chars.')
->param('key', '', new Text(256), 'Package name for Android or bundle ID for iOS or macOS. Max length: 256 chars.', true)
->param('store', '', new Text(256), 'App store or Google Play store ID. Max length: 256 chars.', true)
@@ -2275,6 +2275,7 @@ App::get('/v1/projects/:projectId/templates/email/:type/:locale')
->setParam('{{footer}}', $localeObj->getText("emails.{$type}.footer"))
->setParam('{{body}}', $localeObj->getText('emails.' . $type . '.body'), escapeHtml: false)
->setParam('{{thanks}}', $localeObj->getText("emails.{$type}.thanks"))
+ ->setParam('{{buttonText}}', $localeObj->getText("emails.{$type}.buttonText"))
->setParam('{{signature}}', $localeObj->getText("emails.{$type}.signature"))
->setParam('{{direction}}', $localeObj->getText('settings.direction'));
$message = $message->render();
diff --git a/app/controllers/api/storage.php b/app/controllers/api/storage.php
index 26c789ce27..98a5b105a3 100644
--- a/app/controllers/api/storage.php
+++ b/app/controllers/api/storage.php
@@ -18,6 +18,7 @@ use Appwrite\Utopia\Database\Validator\Queries\Buckets;
use Appwrite\Utopia\Database\Validator\Queries\Files;
use Appwrite\Utopia\Response;
use Utopia\App;
+use Utopia\CLI\Console;
use Utopia\Config\Config;
use Utopia\Database\Database;
use Utopia\Database\DateTime;
@@ -953,12 +954,14 @@ App::get('/v1/storage/buckets/:bucketId/files/:fileId/preview')
->param('output', '', new WhiteList(\array_keys(Config::getParam('storage-outputs')), true), 'Output format type (jpeg, jpg, png, gif and webp).', true)
// NOTE: this is only for the sdk generator and is not used in the action below and is utilised in `resources.php` for `resourceToken`.
->param('token', '', new Text(512), 'File token for accessing this file.', true)
+ ->inject('request')
->inject('response')
->inject('dbForProject')
->inject('resourceToken')
->inject('deviceForFiles')
->inject('deviceForLocal')
- ->action(function (string $bucketId, string $fileId, int $width, int $height, string $gravity, int $quality, int $borderWidth, string $borderColor, int $borderRadius, float $opacity, int $rotation, string $background, string $output, ?string $token, Response $response, Database $dbForProject, Document $resourceToken, Device $deviceForFiles, Device $deviceForLocal) {
+ ->inject('project')
+ ->action(function (string $bucketId, string $fileId, int $width, int $height, string $gravity, int $quality, int $borderWidth, string $borderColor, int $borderRadius, float $opacity, int $rotation, string $background, string $output, ?string $token, Request $request, Response $response, Database $dbForProject, Document $resourceToken, Device $deviceForFiles, Device $deviceForLocal, Document $project) {
if (!\extension_loaded('imagick')) {
throw new Exception(Exception::GENERAL_SERVER_ERROR, 'Imagick extension is missing');
@@ -1035,8 +1038,12 @@ App::get('/v1/storage/buckets/:bucketId/files/:fileId/preview')
$output = empty($type) ? (array_search($mime, $outputs) ?? 'jpg') : $type;
}
+ $startTime = \microtime(true);
+
$source = $deviceForFiles->read($path);
+ $downloadTime = \microtime(true) - $startTime;
+
if (!empty($cipher)) { // Decrypt
$source = OpenSSL::decrypt(
$source,
@@ -1048,6 +1055,8 @@ App::get('/v1/storage/buckets/:bucketId/files/:fileId/preview')
);
}
+ $decryptionTime = \microtime(true) - $startTime - $downloadTime;
+
switch ($algorithm) {
case Compression::ZSTD:
$compressor = new Zstd();
@@ -1059,6 +1068,8 @@ App::get('/v1/storage/buckets/:bucketId/files/:fileId/preview')
break;
}
+ $decompressionTime = \microtime(true) - $startTime - $downloadTime - $decryptionTime;
+
try {
$image = new Image($source);
} catch (ImagickException $e) {
@@ -1089,6 +1100,12 @@ App::get('/v1/storage/buckets/:bucketId/files/:fileId/preview')
$data = $image->output($output, $quality);
+ $renderingTime = \microtime(true) - $startTime - $downloadTime - $decryptionTime - $decompressionTime;
+
+ $totalTime = \microtime(true) - $startTime;
+
+ Console::info("File preview rendered,project=" . $project->getId() . ",bucket=" . $bucketId . ",file=" . $file->getId() . ",uri=" . $request->getURI() . ",total=" . $totalTime . ",rendering=" . $renderingTime . ",decryption=" . $decryptionTime . ",decompression=" . $decompressionTime . ",download=" . $downloadTime);
+
$contentType = (\array_key_exists($output, $outputs)) ? $outputs[$output] : $outputs['jpg'];
//Do not update transformedAt if it's a console user
diff --git a/app/controllers/api/teams.php b/app/controllers/api/teams.php
index e72ea7bc92..98ec49ca48 100644
--- a/app/controllers/api/teams.php
+++ b/app/controllers/api/teams.php
@@ -11,6 +11,7 @@ use Appwrite\Event\Messaging;
use Appwrite\Event\StatsUsage;
use Appwrite\Extend\Exception;
use Appwrite\Network\Validator\Email;
+use Appwrite\Network\Validator\Redirect;
use Appwrite\Platform\Workers\Deletes;
use Appwrite\SDK\AuthType;
use Appwrite\SDK\ContentType;
@@ -50,7 +51,6 @@ use Utopia\Locale\Locale;
use Utopia\System\System;
use Utopia\Validator\ArrayList;
use Utopia\Validator\Assoc;
-use Utopia\Validator\Host;
use Utopia\Validator\Text;
use Utopia\Validator\URL;
use Utopia\Validator\WhiteList;
@@ -466,7 +466,7 @@ App::post('/v1/teams/:teamId/memberships')
}
return new ArrayList(new Key(), APP_LIMIT_ARRAY_PARAMS_SIZE);
}, 'Array of strings. Use this param to set the user roles in the team. A role can be any string. Learn more about [roles and permissions](https://appwrite.io/docs/permissions). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' roles are allowed, each 32 characters long.', false, ['project'])
- ->param('url', '', fn ($clients, $devKey) => $devKey->isEmpty() ? new Host($clients) : new URL(), 'URL to redirect the user back to your app from the invitation email. This parameter is not required when an API key is supplied. Only URLs from hostnames in your project platform list are allowed. This requirement helps to prevent an [open redirect](https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html) attack against your project API.', true, ['clients', 'devKey']) // TODO add our own built-in confirm page
+ ->param('url', '', fn ($platforms, $devKey) => $devKey->isEmpty() ? new Redirect($platforms) : new URL(), 'URL to redirect the user back to your app from the invitation email. This parameter is not required when an API key is supplied. Only URLs from hostnames in your project platform list are allowed. This requirement helps to prevent an [open redirect](https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html) attack against your project API.', true, ['platforms', 'devKey']) // TODO add our own built-in confirm page
->param('name', '', new Text(128), 'Name of the new team member. Max length: 128 chars.', true)
->inject('response')
->inject('project')
@@ -666,6 +666,7 @@ App::post('/v1/teams/:teamId/memberships')
->setParam('{{hello}}', $locale->getText("emails.invitation.hello"))
->setParam('{{footer}}', $locale->getText("emails.invitation.footer"))
->setParam('{{thanks}}', $locale->getText("emails.invitation.thanks"))
+ ->setParam('{{buttonText}}', $locale->getText("emails.invitation.buttonText"))
->setParam('{{signature}}', $locale->getText("emails.invitation.signature"));
$body = $message->render();
diff --git a/app/controllers/api/users.php b/app/controllers/api/users.php
index 0b580170e1..3376f4857c 100644
--- a/app/controllers/api/users.php
+++ b/app/controllers/api/users.php
@@ -649,6 +649,8 @@ App::get('/v1/users')
$total = $dbForProject->count('users', $filterQueries, APP_LIMIT_COUNT);
} catch (OrderException $e) {
throw new Exception(Exception::DATABASE_QUERY_ORDER_NULL, "The order attribute '{$e->getAttribute()}' had a null value. Cursor pagination requires all documents order attribute values are non-null.");
+ } catch (QueryException $e) {
+ throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
}
$response->dynamic(new Document([
'users' => $users,
diff --git a/app/controllers/api/vcs.php b/app/controllers/api/vcs.php
index e8bbd2854c..a8efd093b5 100644
--- a/app/controllers/api/vcs.php
+++ b/app/controllers/api/vcs.php
@@ -4,6 +4,7 @@ use Appwrite\Auth\OAuth2\Github as OAuth2Github;
use Appwrite\Event\Build;
use Appwrite\Event\Delete;
use Appwrite\Extend\Exception;
+use Appwrite\Network\Validator\Redirect;
use Appwrite\SDK\AuthType;
use Appwrite\SDK\ContentType;
use Appwrite\SDK\Method;
@@ -53,7 +54,6 @@ use Utopia\Detector\Detector\Runtime;
use Utopia\Detector\Detector\Strategy;
use Utopia\System\System;
use Utopia\Validator\Boolean;
-use Utopia\Validator\Host;
use Utopia\Validator\Text;
use Utopia\Validator\WhiteList;
use Utopia\VCS\Adapter\Git\GitHub;
@@ -116,8 +116,10 @@ $createGitDeployments = function (GitHub $github, string $providerInstallationId
}
$commentStatus = $isAuthorized ? 'waiting' : 'failed';
+ $protocol = System::getEnv('_APP_OPTIONS_FORCE_HTTPS') === 'disabled' ? 'http' : 'https';
+ $hostname = System::getEnv('_APP_CONSOLE_DOMAIN', System::getEnv('_APP_DOMAIN', ''));
- $authorizeUrl = $request->getProtocol() . '://' . $request->getHostname() . "/console/git/authorize-contributor?projectId={$projectId}&installationId={$installationId}&repositoryId={$repositoryId}&providerPullRequestId={$providerPullRequestId}";
+ $authorizeUrl = $protocol . '://' . $hostname . "/console/git/authorize-contributor?projectId={$projectId}&installationId={$installationId}&repositoryId={$repositoryId}&providerPullRequestId={$providerPullRequestId}";
$action = $isAuthorized ? ['type' => 'logs'] : ['type' => 'authorize', 'url' => $authorizeUrl];
@@ -378,7 +380,7 @@ $createGitDeployments = function (GitHub $github, string $providerInstallationId
}
$owner = $github->getOwnerName($providerInstallationId);
- $providerTargetUrl = $request->getProtocol() . '://' . $request->getHostname() . "/console/project-$region-$projectId/$resourceCollection/$resourceType-$resourceId";
+ $providerTargetUrl = $protocol . '://' . $hostname . "/console/project-$region-$projectId/$resourceCollection/$resourceType-$resourceId";
$github->updateCommitStatus($repositoryName, $providerCommitHash, $owner, 'pending', $message, $providerTargetUrl, $name);
}
@@ -424,8 +426,8 @@ App::get('/v1/vcs/github/authorize')
type: MethodType::WEBAUTH,
hide: true,
))
- ->param('success', '', fn ($clients) => new Host($clients), 'URL to redirect back to console after a successful installation attempt.', true, ['clients'])
- ->param('failure', '', fn ($clients) => new Host($clients), 'URL to redirect back to console after a failed installation attempt.', true, ['clients'])
+ ->param('success', '', fn ($platforms) => new Redirect($platforms), 'URL to redirect back to console after a successful installation attempt.', true, ['platforms'])
+ ->param('failure', '', fn ($platforms) => new Redirect($platforms), 'URL to redirect back to console after a failed installation attempt.', true, ['platforms'])
->inject('request')
->inject('response')
->inject('project')
@@ -437,6 +439,8 @@ App::get('/v1/vcs/github/authorize')
]);
$appName = System::getEnv('_APP_VCS_GITHUB_APP_NAME');
+ $protocol = System::getEnv('_APP_OPTIONS_FORCE_HTTPS') === 'disabled' ? 'http' : 'https';
+ $hostname = System::getEnv('_APP_CONSOLE_DOMAIN', System::getEnv('_APP_DOMAIN', ''));
if (empty($appName)) {
throw new Exception(Exception::GENERAL_SERVER_ERROR, 'GitHub App name is not configured. Please configure VCS (Version Control System) variables in .env file.');
@@ -444,7 +448,7 @@ App::get('/v1/vcs/github/authorize')
$url = "https://github.com/apps/$appName/installations/new?" . \http_build_query([
'state' => $state,
- 'redirect_uri' => $request->getProtocol() . '://' . $request->getHostname() . "/v1/vcs/github/callback"
+ 'redirect_uri' => $protocol . '://' . $hostname . "/v1/vcs/github/callback"
]);
$response
@@ -494,10 +498,12 @@ App::get('/v1/vcs/github/callback')
}
$region = $project->getAttribute('region', 'default');
+ $protocol = System::getEnv('_APP_OPTIONS_FORCE_HTTPS') === 'disabled' ? 'http' : 'https';
+ $hostname = System::getEnv('_APP_CONSOLE_DOMAIN', System::getEnv('_APP_DOMAIN', ''));
$defaultState = [
- 'success' => $request->getProtocol() . '://' . $request->getHostname() . "/console/project-$region-$projectId/settings/git-installations",
- 'failure' => $request->getProtocol() . '://' . $request->getHostname() . "/console/project-$region-$projectId/settings/git-installations",
+ 'success' => $protocol . '://' . $hostname . "/console/project-$region-$projectId/settings/git-installations",
+ 'failure' => $protocol . '://' . $hostname . "/console/project-$region-$projectId/settings/git-installations",
];
$state = \array_merge($defaultState, $state ?? []);
diff --git a/app/controllers/general.php b/app/controllers/general.php
index 5f094b1549..6ecded2385 100644
--- a/app/controllers/general.php
+++ b/app/controllers/general.php
@@ -51,14 +51,13 @@ use Utopia\Logger\Log\User;
use Utopia\Logger\Logger;
use Utopia\Platform\Service;
use Utopia\System\System;
-use Utopia\Validator\Hostname;
use Utopia\Validator\Text;
Config::setParam('domainVerification', false);
Config::setParam('cookieDomain', 'localhost');
Config::setParam('cookieSamesite', Response::COOKIE_SAMESITE_NONE);
-function router(App $utopia, Database $dbForPlatform, callable $getProjectDB, SwooleRequest $swooleRequest, Request $request, Response $response, Event $queueForEvents, StatsUsage $queueForStatsUsage, Func $queueForFunctions, Executor $executor, Reader $geodb, callable $isResourceBlocked, string $previewHostname, ?Key $apiKey)
+function router(App $utopia, Database $dbForPlatform, callable $getProjectDB, SwooleRequest $swooleRequest, Request $request, Response $response, Log $log, Event $queueForEvents, StatsUsage $queueForStatsUsage, Func $queueForFunctions, Executor $executor, Reader $geodb, callable $isResourceBlocked, string $previewHostname, ?Key $apiKey)
{
$host = $request->getHostname() ?? '';
if (!empty($previewHostname)) {
@@ -78,7 +77,7 @@ function router(App $utopia, Database $dbForPlatform, callable $getProjectDB, Sw
}
$errorView = __DIR__ . '/../views/general/error.phtml';
- $url = (System::getEnv('_APP_OPTIONS_FORCE_HTTPS') == 'disabled' ? 'http' : 'https') . '://' . System::getEnv('_APP_DOMAIN', '');
+ $url = (System::getEnv('_APP_OPTIONS_FORCE_HTTPS') == 'disabled' ? 'http' : 'https') . '://' . System::getEnv('_APP_CONSOLE_DOMAIN', System::getEnv('_APP_DOMAIN', ''));
if ($rule->isEmpty()) {
$appDomainFunctionsFallback = System::getEnv('_APP_DOMAIN_FUNCTIONS_FALLBACK', '');
@@ -120,6 +119,11 @@ function router(App $utopia, Database $dbForPlatform, callable $getProjectDB, Sw
$project->setAttribute('accessedAt', DateTime::now());
Authorization::skip(fn () => $dbForPlatform->updateDocument('projects', $project->getId(), $project));
}
+
+ /**
+ * Set projectId to update the Error hook logger, since x-appwrite-project is not available when executing custom domain function
+ */
+ $log->addTag('projectId', $project->getId());
}
if (array_key_exists('proxy', $project->getAttribute('services', []))) {
@@ -264,7 +268,7 @@ function router(App $utopia, Database $dbForPlatform, callable $getProjectDB, Sw
}
if (!$authorized) {
- $url = (System::getEnv('_APP_OPTIONS_FORCE_HTTPS') == 'disabled' ? 'http' : 'https') . "://" . System::getEnv('_APP_DOMAIN');
+ $url = (System::getEnv('_APP_OPTIONS_FORCE_HTTPS') == 'disabled' ? 'http' : 'https') . "://" . System::getEnv('_APP_CONSOLE_DOMAIN', System::getEnv('_APP_DOMAIN', ''));
$response
->addHeader('Cache-Control', 'no-store, no-cache, must-revalidate, max-age=0')
->addHeader('Pragma', 'no-cache')
@@ -450,7 +454,7 @@ function router(App $utopia, Database $dbForPlatform, callable $getProjectDB, Sw
$vars[$var->getAttribute('key')] = $var->getAttribute('value', '');
}
- $protocol = System::getEnv('_APP_OPTIONS_FORCE_HTTPS') == 'disabled' ? 'http' : 'https';
+ $protocol = System::getEnv('_APP_OPTIONS_FORCE_HTTPS') === 'disabled' ? 'http' : 'https';
$hostname = System::getEnv('_APP_DOMAIN');
$endpoint = $protocol . '://' . $hostname . "/v1";
@@ -789,13 +793,14 @@ App::init()
->inject('swooleRequest')
->inject('request')
->inject('response')
+ ->inject('log')
->inject('console')
->inject('project')
->inject('dbForPlatform')
->inject('getProjectDB')
->inject('locale')
->inject('localeCodes')
- ->inject('clients')
+ ->inject('platforms')
->inject('geodb')
->inject('queueForStatsUsage')
->inject('queueForEvents')
@@ -806,7 +811,9 @@ App::init()
->inject('previewHostname')
->inject('devKey')
->inject('apiKey')
- ->action(function (App $utopia, SwooleRequest $swooleRequest, Request $request, Response $response, Document $console, Document $project, Database $dbForPlatform, callable $getProjectDB, Locale $locale, array $localeCodes, array $clients, Reader $geodb, StatsUsage $queueForStatsUsage, Event $queueForEvents, Certificate $queueForCertificates, Func $queueForFunctions, Executor $executor, callable $isResourceBlocked, string $previewHostname, Document $devKey, ?Key $apiKey) {
+ ->inject('httpReferrer')
+ ->inject('httpReferrerSafe')
+ ->action(function (App $utopia, SwooleRequest $swooleRequest, Request $request, Response $response, Log $log, Document $console, Document $project, Database $dbForPlatform, callable $getProjectDB, Locale $locale, array $localeCodes, array $platforms, Reader $geodb, StatsUsage $queueForStatsUsage, Event $queueForEvents, Certificate $queueForCertificates, Func $queueForFunctions, Executor $executor, callable $isResourceBlocked, string $previewHostname, Document $devKey, ?Key $apiKey, string $httpReferrer, string $httpReferrerSafe) {
/*
* Appwrite Router
*/
@@ -814,7 +821,7 @@ App::init()
$mainDomain = System::getEnv('_APP_DOMAIN', '');
// Only run Router when external domain
if ($host !== $mainDomain || !empty($previewHostname)) {
- if (router($utopia, $dbForPlatform, $getProjectDB, $swooleRequest, $request, $response, $queueForEvents, $queueForStatsUsage, $queueForFunctions, $executor, $geodb, $isResourceBlocked, $previewHostname, $apiKey)) {
+ if (router($utopia, $dbForPlatform, $getProjectDB, $swooleRequest, $request, $response, $log, $queueForEvents, $queueForStatsUsage, $queueForFunctions, $executor, $geodb, $isResourceBlocked, $previewHostname, $apiKey)) {
$utopia->getRoute()?->label('router', true);
}
}
@@ -942,42 +949,9 @@ App::init()
$locale->setDefault($localeParam);
}
- $referrer = $request->getReferer();
- $origin = \parse_url($request->getOrigin($referrer), PHP_URL_HOST);
- $protocol = \parse_url($request->getOrigin($referrer), PHP_URL_SCHEME);
- $port = \parse_url($request->getOrigin($referrer), PHP_URL_PORT);
-
- $refDomainOrigin = 'localhost';
- $validator = new Hostname($clients);
- if ($validator->isValid($origin)) {
- $refDomainOrigin = $origin;
- } elseif (!empty($origin)) {
- // Auto-allow domains with linked rule
- if (System::getEnv('_APP_RULES_FORMAT') === 'md5') {
- $rule = Authorization::skip(fn () => $dbForPlatform->getDocument('rules', md5($origin ?? '')));
- } else {
- $rule = Authorization::skip(
- fn () => $dbForPlatform->find('rules', [
- Query::equal('domain', [$origin]),
- Query::limit(1)
- ])
- )[0] ?? new Document();
- }
-
- if (!$rule->isEmpty() && $rule->getAttribute('projectInternalId') === $project->getSequence()) {
- $refDomainOrigin = $origin;
- }
- }
-
- $refDomain = (!empty($protocol) ? $protocol : $request->getProtocol()) . '://' . $refDomainOrigin . (!empty($port) ? ':' . $port : '');
-
- $refDomain = (!$route->getLabel('origin', false)) // This route is publicly accessible
- ? $refDomain
- : (!empty($protocol) ? $protocol : $request->getProtocol()) . '://' . $origin . (!empty($port) ? ':' . $port : '');
-
+ $origin = \parse_url($request->getOrigin($httpReferrer), PHP_URL_HOST);
$selfDomain = new Domain($request->getHostname());
$endDomain = new Domain((string)$origin);
-
Config::setParam(
'domainVerification',
($selfDomain->getRegisterable() === $endDomain->getRegisterable()) &&
@@ -1052,7 +1026,7 @@ App::init()
->addHeader('Access-Control-Allow-Methods', 'GET, POST, PUT, PATCH, DELETE')
->addHeader('Access-Control-Allow-Headers', 'Origin, Cookie, Set-Cookie, X-Requested-With, Content-Type, Access-Control-Allow-Origin, Access-Control-Request-Headers, Accept, X-Appwrite-Project, X-Appwrite-Key, X-Appwrite-Dev-Key, X-Appwrite-Locale, X-Appwrite-Mode, X-Appwrite-JWT, X-Appwrite-Response-Format, X-Appwrite-Timeout, X-SDK-Version, X-SDK-Name, X-SDK-Language, X-SDK-Platform, X-SDK-GraphQL, X-Appwrite-ID, X-Appwrite-Timestamp, Content-Range, Range, Cache-Control, Expires, Pragma, X-Forwarded-For, X-Forwarded-User-Agent')
->addHeader('Access-Control-Expose-Headers', 'X-Appwrite-Session, X-Fallback-Cookies')
- ->addHeader('Access-Control-Allow-Origin', $refDomain)
+ ->addHeader('Access-Control-Allow-Origin', $httpReferrerSafe)
->addHeader('Access-Control-Allow-Credentials', 'true');
if (!$devKey->isEmpty()) {
@@ -1065,14 +1039,16 @@ App::init()
* Skip this check for non-web platforms which are not required to send an origin header
*/
$origin = $request->getOrigin($request->getReferer(''));
- $originValidator = new Origin(\array_merge($project->getAttribute('platforms', []), $console->getAttribute('platforms', [])));
+ $originValidator = new Origin($platforms);
if (
- !$originValidator->isValid($origin)
- && $devKey->isEmpty()
+ $devKey->isEmpty()
+ && !empty($origin)
+ && !$originValidator->isValid($origin)
&& \in_array($request->getMethod(), [Request::METHOD_POST, Request::METHOD_PUT, Request::METHOD_PATCH, Request::METHOD_DELETE])
&& $route->getLabel('origin', false) !== '*'
&& empty($request->getHeader('x-appwrite-key', ''))
+ && \parse_url($httpReferrerSafe, PHP_URL_HOST) === 'localhost'
) {
throw new AppwriteException(AppwriteException::GENERAL_UNKNOWN_ORIGIN, $originValidator->getDescription());
}
@@ -1083,6 +1059,7 @@ App::options()
->inject('swooleRequest')
->inject('request')
->inject('response')
+ ->inject('log')
->inject('dbForPlatform')
->inject('getProjectDB')
->inject('queueForEvents')
@@ -1095,7 +1072,7 @@ App::options()
->inject('project')
->inject('devKey')
->inject('apiKey')
- ->action(function (App $utopia, SwooleRequest $swooleRequest, Request $request, Response $response, Database $dbForPlatform, callable $getProjectDB, Event $queueForEvents, StatsUsage $queueForStatsUsage, Func $queueForFunctions, Executor $executor, Reader $geodb, callable $isResourceBlocked, string $previewHostname, Document $project, Document $devKey, ?Key $apiKey) {
+ ->action(function (App $utopia, SwooleRequest $swooleRequest, Request $request, Response $response, Log $log, Database $dbForPlatform, callable $getProjectDB, Event $queueForEvents, StatsUsage $queueForStatsUsage, Func $queueForFunctions, Executor $executor, Reader $geodb, callable $isResourceBlocked, string $previewHostname, Document $project, Document $devKey, ?Key $apiKey) {
/*
* Appwrite Router
*/
@@ -1103,7 +1080,7 @@ App::options()
$mainDomain = System::getEnv('_APP_DOMAIN', '');
// Only run Router when external domain
if ($host !== $mainDomain || !empty($previewHostname)) {
- if (router($utopia, $dbForPlatform, $getProjectDB, $swooleRequest, $request, $response, $queueForEvents, $queueForStatsUsage, $queueForFunctions, $executor, $geodb, $isResourceBlocked, $previewHostname, $apiKey)) {
+ if (router($utopia, $dbForPlatform, $getProjectDB, $swooleRequest, $request, $response, $log, $queueForEvents, $queueForStatsUsage, $queueForFunctions, $executor, $geodb, $isResourceBlocked, $previewHostname, $apiKey)) {
$utopia->getRoute()?->label('router', true);
}
}
@@ -1276,7 +1253,12 @@ App::error()
$log->addTag('url', $request->getURI());
$log->addTag('verboseType', get_class($error));
$log->addTag('code', $error->getCode());
- $log->addTag('projectId', $project->getId());
+
+ $tags = $log->getTags();
+ if (!isset($tags['projectId'])) {
+ $log->addTag('projectId', $project->getId());
+ }
+
$log->addTag('hostname', $request->getHostname());
$log->addTag('locale', (string)$request->getParam('locale', $request->getHeader('x-appwrite-locale', '')));
@@ -1394,6 +1376,7 @@ App::get('/robots.txt')
->inject('swooleRequest')
->inject('request')
->inject('response')
+ ->inject('log')
->inject('dbForPlatform')
->inject('getProjectDB')
->inject('queueForEvents')
@@ -1404,7 +1387,7 @@ App::get('/robots.txt')
->inject('isResourceBlocked')
->inject('previewHostname')
->inject('apiKey')
- ->action(function (App $utopia, SwooleRequest $swooleRequest, Request $request, Response $response, Database $dbForPlatform, callable $getProjectDB, Event $queueForEvents, StatsUsage $queueForStatsUsage, Func $queueForFunctions, Executor $executor, Reader $geodb, callable $isResourceBlocked, string $previewHostname, ?Key $apiKey) {
+ ->action(function (App $utopia, SwooleRequest $swooleRequest, Request $request, Response $response, Log $log, Database $dbForPlatform, callable $getProjectDB, Event $queueForEvents, StatsUsage $queueForStatsUsage, Func $queueForFunctions, Executor $executor, Reader $geodb, callable $isResourceBlocked, string $previewHostname, ?Key $apiKey) {
$host = $request->getHostname() ?? '';
$mainDomain = System::getEnv('_APP_DOMAIN', '');
@@ -1412,7 +1395,7 @@ App::get('/robots.txt')
$template = new View(__DIR__ . '/../views/general/robots.phtml');
$response->text($template->render(false));
} else {
- if (router($utopia, $dbForPlatform, $getProjectDB, $swooleRequest, $request, $response, $queueForEvents, $queueForStatsUsage, $queueForFunctions, $executor, $geodb, $isResourceBlocked, $previewHostname, $apiKey)) {
+ if (router($utopia, $dbForPlatform, $getProjectDB, $swooleRequest, $request, $response, $log, $queueForEvents, $queueForStatsUsage, $queueForFunctions, $executor, $geodb, $isResourceBlocked, $previewHostname, $apiKey)) {
$utopia->getRoute()?->label('router', true);
}
}
@@ -1426,6 +1409,7 @@ App::get('/humans.txt')
->inject('swooleRequest')
->inject('request')
->inject('response')
+ ->inject('log')
->inject('dbForPlatform')
->inject('getProjectDB')
->inject('queueForEvents')
@@ -1436,7 +1420,7 @@ App::get('/humans.txt')
->inject('isResourceBlocked')
->inject('previewHostname')
->inject('apiKey')
- ->action(function (App $utopia, SwooleRequest $swooleRequest, Request $request, Response $response, Database $dbForPlatform, callable $getProjectDB, Event $queueForEvents, StatsUsage $queueForStatsUsage, Func $queueForFunctions, Executor $executor, Reader $geodb, callable $isResourceBlocked, string $previewHostname, ?Key $apiKey) {
+ ->action(function (App $utopia, SwooleRequest $swooleRequest, Request $request, Response $response, Log $log, Database $dbForPlatform, callable $getProjectDB, Event $queueForEvents, StatsUsage $queueForStatsUsage, Func $queueForFunctions, Executor $executor, Reader $geodb, callable $isResourceBlocked, string $previewHostname, ?Key $apiKey) {
$host = $request->getHostname() ?? '';
$mainDomain = System::getEnv('_APP_DOMAIN', '');
@@ -1444,7 +1428,7 @@ App::get('/humans.txt')
$template = new View(__DIR__ . '/../views/general/humans.phtml');
$response->text($template->render(false));
} else {
- if (router($utopia, $dbForPlatform, $getProjectDB, $swooleRequest, $request, $response, $queueForEvents, $queueForStatsUsage, $queueForFunctions, $executor, $geodb, $isResourceBlocked, $previewHostname, $apiKey)) {
+ if (router($utopia, $dbForPlatform, $getProjectDB, $swooleRequest, $request, $response, $log, $queueForEvents, $queueForStatsUsage, $queueForFunctions, $executor, $geodb, $isResourceBlocked, $previewHostname, $apiKey)) {
$utopia->getRoute()?->label('router', true);
}
}
diff --git a/app/controllers/shared/api.php b/app/controllers/shared/api.php
index f99ebbce07..76fe177b0b 100644
--- a/app/controllers/shared/api.php
+++ b/app/controllers/shared/api.php
@@ -22,6 +22,7 @@ use Utopia\Abuse\Abuse;
use Utopia\App;
use Utopia\Cache\Adapter\Filesystem;
use Utopia\Cache\Cache;
+use Utopia\CLI\Console;
use Utopia\Config\Config;
use Utopia\Database\Database;
use Utopia\Database\DateTime;
@@ -563,7 +564,7 @@ App::init()
$cache = new Cache(
new Filesystem(APP_STORAGE_CACHE . DIRECTORY_SEPARATOR . 'app-' . $project->getId())
);
- $timestamp = 60 * 60 * 24 * 30;
+ $timestamp = 60 * 60 * 24 * 180; // Temporarily increase the TTL to 180 day to ensure files in the cache are still fetched.
$data = $cache->load($key, $timestamp);
if (!empty($data) && !$cacheLog->isEmpty()) {
@@ -797,6 +798,12 @@ App::shutdown()
}
if (!empty($queueForDatabase->getType())) {
+ Console::info("Triggering database event: \n" . \json_encode([
+ 'projectId' => $project->getId(),
+ 'databaseId' => $queueForDatabase->getDatabase()?->getId(),
+ 'collectionId' => $queueForDatabase->getCollection()?->getId(),
+ 'documentId' => $queueForDatabase->getDocument()?->getId(),
+ ]));
$queueForDatabase->trigger();
}
@@ -824,6 +831,10 @@ App::shutdown()
$resourceType = $parseLabel($pattern, $responsePayload, $requestParams, $user);
}
+ $cache = new Cache(
+ new Filesystem(APP_STORAGE_CACHE . DIRECTORY_SEPARATOR . 'app-' . $project->getId())
+ );
+
$key = $request->cacheIdentifier();
$signature = md5($data['payload']);
$cacheLog = Authorization::skip(fn () => $dbForProject->getDocument('cache', $key));
@@ -841,12 +852,11 @@ App::shutdown()
} elseif (DateTime::formatTz(DateTime::addSeconds(new \DateTime(), -APP_CACHE_UPDATE)) > $accessedAt) {
$cacheLog->setAttribute('accessedAt', $now);
Authorization::skip(fn () => $dbForProject->updateDocument('cache', $cacheLog->getId(), $cacheLog));
+ // Overwrite the file every APP_CACHE_UPDATE seconds to update the file modified time that is used in the TTL checks in cache->load()
+ $cache->save($key, $data['payload']);
}
if ($signature !== $cacheLog->getAttribute('signature')) {
- $cache = new Cache(
- new Filesystem(APP_STORAGE_CACHE . DIRECTORY_SEPARATOR . 'app-' . $project->getId())
- );
$cache->save($key, $data['payload']);
}
}
diff --git a/app/init/registers.php b/app/init/registers.php
index 415730f936..3dc0e22dba 100644
--- a/app/init/registers.php
+++ b/app/init/registers.php
@@ -36,7 +36,8 @@ App::setMode(System::getEnv('_APP_ENV', App::MODE_TYPE_PRODUCTION));
if (!App::isProduction()) {
// Allow specific domains to skip public domain validation in dev environment
// Useful for existing tests involving webhooks
- PublicDomain::allow(['request-catcher']);
+ PublicDomain::allow(['request-catcher-sms']);
+ PublicDomain::allow(['request-catcher-webhook']);
}
$register->set('logger', function () {
// Register error logger
diff --git a/app/init/resources.php b/app/init/resources.php
index 5f65fe683f..b75c32cba0 100644
--- a/app/init/resources.php
+++ b/app/init/resources.php
@@ -19,6 +19,7 @@ use Appwrite\Event\StatsUsage;
use Appwrite\Event\Webhook;
use Appwrite\Extend\Exception;
use Appwrite\GraphQL\Schema;
+use Appwrite\Network\Platform;
use Appwrite\Network\Validator\Origin;
use Appwrite\Utopia\Request;
use Executor\Executor;
@@ -79,9 +80,15 @@ App::setResource('localeCodes', function () {
App::setResource('publisher', function (Group $pools) {
return new BrokerPool(publisher: $pools->get('publisher'));
}, ['pools']);
+App::setResource('publisherRedis', function () {
+ // Stub
+});
App::setResource('consumer', function (Group $pools) {
return new BrokerPool(consumer: $pools->get('consumer'));
}, ['pools']);
+App::setResource('consumerRedis', function () {
+ // Stub
+});
App::setResource('queueForMessaging', function (Publisher $publisher) {
return new Messaging($publisher);
}, ['publisher']);
@@ -121,11 +128,11 @@ App::setResource('queueForCertificates', function (Publisher $publisher) {
App::setResource('queueForMigrations', function (Publisher $publisher) {
return new Migration($publisher);
}, ['publisher']);
-App::setResource('clients', function ($request, $console, $project) {
+App::setResource('platforms', function (Request $request, Document $console, Document $project) {
$console->setAttribute('platforms', [ // Always allow current host
'$collection' => ID::custom('platforms'),
'name' => 'Current Host',
- 'type' => Origin::CLIENT_TYPE_WEB,
+ 'type' => Platform::TYPE_WEB,
'hostname' => $request->getHostname(),
], Document::SET_TYPE_APPEND);
@@ -138,39 +145,32 @@ App::setResource('clients', function ($request, $console, $project) {
}
$console->setAttribute('platforms', [
'$collection' => ID::custom('platforms'),
- 'type' => Origin::CLIENT_TYPE_WEB,
+ 'type' => Platform::TYPE_WEB,
'name' => $hostname,
'hostname' => $hostname,
], Document::SET_TYPE_APPEND);
}
- /**
- * Get All verified client URLs for both console and current projects
- * + Filter for duplicated entries
- */
- $clientsConsole = \array_map(
- fn ($node) => $node['hostname'],
- \array_filter(
- $console->getAttribute('platforms', []),
- fn ($node) => (isset($node['type']) && ($node['type'] === Origin::CLIENT_TYPE_WEB) && !empty($node['hostname']))
- )
- );
-
- $clients = $clientsConsole;
- $platforms = $project->getAttribute('platforms', []);
-
- foreach ($platforms as $node) {
- if (
- isset($node['type']) &&
- ($node['type'] === Origin::CLIENT_TYPE_WEB ||
- $node['type'] === Origin::CLIENT_TYPE_FLUTTER_WEB) &&
- !empty($node['hostname'])
- ) {
- $clients[] = $node['hostname'];
- }
+ // Add `exp` and `appwrite-callback-{projectId}` schemes
+ if (!$project->isEmpty() && $project->getId() !== 'console') {
+ $project->setAttribute('platforms', [
+ '$collection' => ID::custom('platforms'),
+ 'type' => Platform::TYPE_SCHEME,
+ 'name' => 'Expo',
+ 'key' => 'exp',
+ ], Document::SET_TYPE_APPEND);
+ $project->setAttribute('platforms', [
+ '$collection' => ID::custom('platforms'),
+ 'type' => Platform::TYPE_SCHEME,
+ 'name' => 'Appwrite Callback',
+ 'key' => 'appwrite-callback-' . $project->getId(),
+ ], Document::SET_TYPE_APPEND);
}
- return \array_unique($clients);
+ return [
+ ...$console->getAttribute('platforms', []),
+ ...$project->getAttribute('platforms', []),
+ ];
}, ['request', 'console', 'project']);
App::setResource('user', function ($mode, $project, $console, $request, $response, $dbForProject, $dbForPlatform) {
@@ -222,7 +222,9 @@ App::setResource('user', function ($mode, $project, $console, $request, $respons
Auth::$unique = $session['id'] ?? '';
Auth::$secret = $session['secret'] ?? '';
- if (APP_MODE_ADMIN !== $mode) {
+ if ($mode === APP_MODE_ADMIN) {
+ $user = $dbForPlatform->getDocument('users', Auth::$unique);
+ } else {
if ($project->isEmpty()) {
$user = new Document([]);
} else {
@@ -232,8 +234,6 @@ App::setResource('user', function ($mode, $project, $console, $request, $respons
$user = $dbForProject->getDocument('users', Auth::$unique);
}
}
- } else {
- $user = $dbForPlatform->getDocument('users', Auth::$unique);
}
if (
@@ -264,7 +264,11 @@ App::setResource('user', function ($mode, $project, $console, $request, $respons
$jwtUserId = $payload['userId'] ?? '';
if (!empty($jwtUserId)) {
- $user = $dbForProject->getDocument('users', $jwtUserId);
+ if ($mode === APP_MODE_ADMIN) {
+ $user = $dbForPlatform->getDocument('users', $jwtUserId);
+ } else {
+ $user = $dbForProject->getDocument('users', $jwtUserId);
+ }
}
$jwtSessionId = $payload['sessionId'] ?? '';
@@ -684,6 +688,7 @@ App::setResource('schema', function ($utopia, $dbForProject) {
},
];
+ // NOTE: `params` and `urls` are not used internally in the `Schema::build` function below!
$params = [
'list' => function (string $databaseId, string $collectionId, array $args) {
return [ 'queries' => $args['queries']];
@@ -944,3 +949,52 @@ App::setResource('resourceToken', function ($project, $dbForProject, $request) {
}
return new Document([]);
}, ['project', 'dbForProject', 'request']);
+
+App::setResource('httpReferrer', function (Request $request): string {
+ $referrer = $request->getReferer();
+ return $referrer;
+}, ['request']);
+
+App::setResource('httpReferrerSafe', function (Request $request, string $httpReferrer, array $platforms, Database $dbForPlatform, Document $project, App $utopia): string {
+ $origin = \parse_url($request->getOrigin($httpReferrer), PHP_URL_HOST);
+ $protocol = \parse_url($request->getOrigin($httpReferrer), PHP_URL_SCHEME);
+ $port = \parse_url($request->getOrigin($httpReferrer), PHP_URL_PORT);
+ $referrer = (!empty($protocol) ? $protocol : $request->getProtocol()) . '://' . $origin . (!empty($port) ? ':' . $port : '');
+
+ // Safe if route is publicly accessible
+ $route = $utopia->getRoute();
+ if ($route->getLabel('origin', false)) {
+ return $referrer;
+ }
+
+ // Safe if added as web platform
+ $originValidator = new Origin($platforms);
+ if ($originValidator->isValid($request->getOrigin($httpReferrer))) {
+ return $referrer;
+ }
+
+ // Safe if rule with same project ID exists
+ if (!empty($origin)) {
+ if (System::getEnv('_APP_RULES_FORMAT') === 'md5') {
+ $rule = Authorization::skip(fn () => $dbForPlatform->getDocument('rules', md5($origin ?? '')));
+ } else {
+ $rule = Authorization::skip(
+ fn () => $dbForPlatform->find('rules', [
+ Query::equal('domain', [$origin]),
+ Query::limit(1)
+ ])
+ )[0] ?? new Document();
+ }
+
+ if (!$rule->isEmpty() && $rule->getAttribute('projectInternalId') === $project->getSequence()) {
+ return $referrer;
+ }
+ }
+
+ // Unsafe; Localhost is always safe for ease of local development
+ $origin = 'localhost';
+ $protocol = \parse_url($request->getOrigin($httpReferrer), PHP_URL_SCHEME);
+ $port = \parse_url($request->getOrigin($httpReferrer), PHP_URL_PORT);
+ $referrer = (!empty($protocol) ? $protocol : $request->getProtocol()) . '://' . $origin . (!empty($port) ? ':' . $port : '');
+ return $referrer;
+}, ['request', 'httpReferrer', 'platforms', 'dbForPlatform', 'project', 'utopia']);
diff --git a/app/realtime.php b/app/realtime.php
index df8cd5c471..bb0d4da78c 100644
--- a/app/realtime.php
+++ b/app/realtime.php
@@ -532,7 +532,7 @@ $server->onOpen(function (int $connection, SwooleRequest $request) use ($server,
}
$timelimit = $app->getResource('timelimit');
- $console = $app->getResource('console'); /** @var Document $console */
+ $platforms = $app->getResource('platforms');
$user = $app->getResource('user'); /** @var Document $user */
/*
@@ -557,9 +557,9 @@ $server->onOpen(function (int $connection, SwooleRequest $request) use ($server,
* Skip this check for non-web platforms which are not required to send an origin header.
*/
$origin = $request->getOrigin();
- $originValidator = new Origin(array_merge($project->getAttribute('platforms', []), $console->getAttribute('platforms', [])));
+ $originValidator = new Origin($platforms);
- if (!$originValidator->isValid($origin) && $project->getId() !== 'console') {
+ if (!empty($origin) && !$originValidator->isValid($origin) && $project->getId() !== 'console') {
throw new Exception(Exception::REALTIME_POLICY_VIOLATION, $originValidator->getDescription());
}
diff --git a/app/views/general/error.phtml b/app/views/general/error.phtml
index a427f1d5e8..de859a9c86 100644
--- a/app/views/general/error.phtml
+++ b/app/views/general/error.phtml
@@ -15,7 +15,7 @@ $labelClass = '';
$buttons = [];
$protocol = System::getEnv('_APP_OPTIONS_FORCE_HTTPS') == 'disabled' ? 'http' : 'https';
-$hostname = System::getEnv('_APP_DOMAIN');
+$hostname = System::getEnv('_APP_CONSOLE_DOMAIN', System::getEnv('_APP_DOMAIN', ''));
// TODO: remove this later
if (System::getEnv('_APP_ENV') === 'development') {
$hostname = 'localhost';
diff --git a/app/views/install/compose.phtml b/app/views/install/compose.phtml
index e3699662a4..89facfe0f1 100644
--- a/app/views/install/compose.phtml
+++ b/app/views/install/compose.phtml
@@ -864,7 +864,7 @@ $image = $this->getParam('image', '');
<<: *x-logging
restart: unless-stopped
stop_signal: SIGINT
- image: openruntimes/executor:0.7.20
+ image: openruntimes/executor:0.7.22
networks:
- appwrite
- runtimes
diff --git a/app/worker.php b/app/worker.php
index e57aae91d2..4f0f569a9e 100644
--- a/app/worker.php
+++ b/app/worker.php
@@ -18,9 +18,7 @@ use Appwrite\Event\StatsUsage;
use Appwrite\Event\Webhook;
use Appwrite\Platform\Appwrite;
use Executor\Executor;
-use Swoole\Process;
use Swoole\Runtime;
-use Swoole\Timer;
use Utopia\Abuse\Adapters\TimeLimit\Redis as TimeLimitRedis;
use Utopia\Cache\Adapter\Pool as CachePool;
use Utopia\Cache\Adapter\Sharding;
@@ -249,10 +247,18 @@ Server::setResource('publisher', function (Group $pools) {
return new BrokerPool(publisher: $pools->get('publisher'));
}, ['pools']);
+Server::setResource('publisherRedis', function () {
+ // Stub
+});
+
Server::setResource('consumer', function (Group $pools) {
return new BrokerPool(consumer: $pools->get('consumer'));
}, ['pools']);
+Server::setResource('consumerRedis', function () {
+ // Stub
+});
+
Server::setResource('queueForStatsUsage', function (Publisher $publisher) {
return new StatsUsage($publisher);
}, ['publisher']);
@@ -484,15 +490,8 @@ $worker
});
$worker->workerStart()
- ->action(function () use ($worker, $workerName) {
- Console::info("Worker $workerName started");
-
- Process::signal(SIGTERM, function () use ($worker, $workerName) {
- Console::info("Stopping worker $workerName.");
-
- $worker->stop();
- Timer::clearAll();
- });
+ ->action(function () use ($workerName) {
+ Console::info("Worker $workerName started");
});
$worker->start();
diff --git a/bin/doctor b/bin/doctor
index 92b3cf6bf8..b2a4547156 100755
--- a/bin/doctor
+++ b/bin/doctor
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/cli.php doctor $@
+php /usr/src/code/app/cli.php doctor $@
\ No newline at end of file
diff --git a/bin/install b/bin/install
index 126d5373bf..e669e91e6b 100755
--- a/bin/install
+++ b/bin/install
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/cli.php install $@
+php /usr/src/code/app/cli.php install $@
\ No newline at end of file
diff --git a/bin/maintenance b/bin/maintenance
index 70273feb61..099551cb32 100644
--- a/bin/maintenance
+++ b/bin/maintenance
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/cli.php maintenance $@
+php /usr/src/code/app/cli.php maintenance $@
\ No newline at end of file
diff --git a/bin/migrate b/bin/migrate
index 32bf7ee2f4..28ebbd19e7 100755
--- a/bin/migrate
+++ b/bin/migrate
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/cli.php migrate $@
+php /usr/src/code/app/cli.php migrate $@
\ No newline at end of file
diff --git a/bin/queue-count-failed b/bin/queue-count-failed
index 93a6b3136c..ca8f2b4291 100644
--- a/bin/queue-count-failed
+++ b/bin/queue-count-failed
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/cli.php queue-count --type=failed $@
+php /usr/src/code/app/cli.php queue-count --type=failed $@
\ No newline at end of file
diff --git a/bin/queue-count-processing b/bin/queue-count-processing
index 18e89664bd..325d86111d 100644
--- a/bin/queue-count-processing
+++ b/bin/queue-count-processing
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/cli.php queue-count --type=processing $@
+php /usr/src/code/app/cli.php queue-count --type=processing $@
\ No newline at end of file
diff --git a/bin/queue-count-success b/bin/queue-count-success
index b38bfa2159..34fc54b4c1 100644
--- a/bin/queue-count-success
+++ b/bin/queue-count-success
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/cli.php queue-count --type=success $@
+php /usr/src/code/app/cli.php queue-count --type=success $@
\ No newline at end of file
diff --git a/bin/queue-retry b/bin/queue-retry
index 2224a66b3b..f9473e6b07 100644
--- a/bin/queue-retry
+++ b/bin/queue-retry
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/cli.php queue-retry $@
+php /usr/src/code/app/cli.php queue-retry $@
\ No newline at end of file
diff --git a/bin/realtime b/bin/realtime
index debd4baf2a..e43dc269e0 100644
--- a/bin/realtime
+++ b/bin/realtime
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/realtime.php $@
+php /usr/src/code/app/realtime.php $@
\ No newline at end of file
diff --git a/bin/schedule-executions b/bin/schedule-executions
index 5d503e374c..f239cad206 100644
--- a/bin/schedule-executions
+++ b/bin/schedule-executions
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/cli.php schedule-executions $@
+php /usr/src/code/app/cli.php schedule-executions $@
\ No newline at end of file
diff --git a/bin/schedule-functions b/bin/schedule-functions
index beca1a0420..10edbe8226 100644
--- a/bin/schedule-functions
+++ b/bin/schedule-functions
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/cli.php schedule-functions $@
+php /usr/src/code/app/cli.php schedule-functions $@
\ No newline at end of file
diff --git a/bin/schedule-messages b/bin/schedule-messages
index 3f17a279b5..fa7219f6ea 100644
--- a/bin/schedule-messages
+++ b/bin/schedule-messages
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/cli.php schedule-messages $@
+php /usr/src/code/app/cli.php schedule-messages $@
\ No newline at end of file
diff --git a/bin/screenshot b/bin/screenshot
index aef15eb96f..4d8ceb998f 100755
--- a/bin/screenshot
+++ b/bin/screenshot
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/cli.php screenshot $@
\ No newline at end of file
+php /usr/src/code/app/cli.php screenshot $@
\ No newline at end of file
diff --git a/bin/sdks b/bin/sdks
index 3180813ea1..ab73414829 100644
--- a/bin/sdks
+++ b/bin/sdks
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/cli.php sdks $@
+php /usr/src/code/app/cli.php sdks $@
\ No newline at end of file
diff --git a/bin/specs b/bin/specs
index 52875a1675..e77d1487d4 100644
--- a/bin/specs
+++ b/bin/specs
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/cli.php specs $@
+php /usr/src/code/app/cli.php specs $@
\ No newline at end of file
diff --git a/bin/ssl b/bin/ssl
index 0cc12375d0..83dcf6a026 100755
--- a/bin/ssl
+++ b/bin/ssl
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/cli.php ssl $@
+php /usr/src/code/app/cli.php ssl $@
\ No newline at end of file
diff --git a/bin/stats-resources b/bin/stats-resources
index 9cc67fb4a6..3104bab896 100644
--- a/bin/stats-resources
+++ b/bin/stats-resources
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/cli.php stats-resources $@
+php /usr/src/code/app/cli.php stats-resources $@
\ No newline at end of file
diff --git a/bin/test b/bin/test
index c3b0d9b74c..a2153fc536 100755
--- a/bin/test
+++ b/bin/test
@@ -1,3 +1,3 @@
#!/bin/sh
-exec /usr/src/code/vendor/bin/phpunit --configuration /usr/src/code/phpunit.xml $@
+/usr/src/code/vendor/bin/phpunit --configuration /usr/src/code/phpunit.xml $@
\ No newline at end of file
diff --git a/bin/upgrade b/bin/upgrade
index fd1f35b65a..ce32b9ca30 100755
--- a/bin/upgrade
+++ b/bin/upgrade
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/cli.php upgrade $@
+php /usr/src/code/app/cli.php upgrade $@
\ No newline at end of file
diff --git a/bin/vars b/bin/vars
index 238d004675..19e3f1ebf2 100644
--- a/bin/vars
+++ b/bin/vars
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/cli.php vars $@
+php /usr/src/code/app/cli.php vars $@
\ No newline at end of file
diff --git a/bin/worker-audits b/bin/worker-audits
index 9bf81b93e2..3df65d65e8 100644
--- a/bin/worker-audits
+++ b/bin/worker-audits
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/worker.php audits $@
+php /usr/src/code/app/worker.php audits $@
\ No newline at end of file
diff --git a/bin/worker-builds b/bin/worker-builds
index 7ddf5792de..3400111cb5 100644
--- a/bin/worker-builds
+++ b/bin/worker-builds
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/worker.php builds $@
+php /usr/src/code/app/worker.php builds $@
\ No newline at end of file
diff --git a/bin/worker-certificates b/bin/worker-certificates
index 958627bc33..901688c4c8 100755
--- a/bin/worker-certificates
+++ b/bin/worker-certificates
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/worker.php certificates $@
+php /usr/src/code/app/worker.php certificates $@
\ No newline at end of file
diff --git a/bin/worker-databases b/bin/worker-databases
index 235c16927c..61e09aa9f1 100644
--- a/bin/worker-databases
+++ b/bin/worker-databases
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/worker.php databases $@
+php /usr/src/code/app/worker.php databases $@
diff --git a/bin/worker-deletes b/bin/worker-deletes
index c9711a4e66..7c9793e6cb 100644
--- a/bin/worker-deletes
+++ b/bin/worker-deletes
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/worker.php deletes $@
+php /usr/src/code/app/worker.php deletes $@
\ No newline at end of file
diff --git a/bin/worker-functions b/bin/worker-functions
index e82506d0e2..4757b1b72a 100644
--- a/bin/worker-functions
+++ b/bin/worker-functions
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/worker.php functions $@
+php /usr/src/code/app/worker.php functions $@
\ No newline at end of file
diff --git a/bin/worker-mails b/bin/worker-mails
index ffb4f7ea77..fee8a96da7 100644
--- a/bin/worker-mails
+++ b/bin/worker-mails
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/worker.php mails $@
+php /usr/src/code/app/worker.php mails $@
\ No newline at end of file
diff --git a/bin/worker-messaging b/bin/worker-messaging
index 6f39348419..e6edf80f06 100644
--- a/bin/worker-messaging
+++ b/bin/worker-messaging
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/worker.php messaging $@
+php /usr/src/code/app/worker.php messaging $@
\ No newline at end of file
diff --git a/bin/worker-migrations b/bin/worker-migrations
index 2728d9d22c..32d4aef468 100644
--- a/bin/worker-migrations
+++ b/bin/worker-migrations
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/worker.php migrations $@
+php /usr/src/code/app/worker.php migrations $@
\ No newline at end of file
diff --git a/bin/worker-stats-resources b/bin/worker-stats-resources
index 70bfacbe52..9c5d2bebff 100644
--- a/bin/worker-stats-resources
+++ b/bin/worker-stats-resources
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/worker.php stats-resources $@
+php /usr/src/code/app/worker.php stats-resources $@
\ No newline at end of file
diff --git a/bin/worker-stats-usage b/bin/worker-stats-usage
index e6dd849a48..2c267d805e 100644
--- a/bin/worker-stats-usage
+++ b/bin/worker-stats-usage
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/worker.php stats-usage $@
+php /usr/src/code/app/worker.php stats-usage $@
\ No newline at end of file
diff --git a/bin/worker-webhooks b/bin/worker-webhooks
index 63fc13e3c5..93f8027a81 100644
--- a/bin/worker-webhooks
+++ b/bin/worker-webhooks
@@ -1,3 +1,3 @@
#!/bin/sh
-exec php /usr/src/code/app/worker.php webhooks $@
+php /usr/src/code/app/worker.php webhooks $@
\ No newline at end of file
diff --git a/composer.json b/composer.json
index 18507e04f1..4c36ab125d 100644
--- a/composer.json
+++ b/composer.json
@@ -67,7 +67,7 @@
"utopia-php/platform": "0.7.*",
"utopia-php/pools": "0.8.*",
"utopia-php/preloader": "0.2.*",
- "utopia-php/queue": "0.11.*",
+ "utopia-php/queue": "0.11.0",
"utopia-php/registry": "0.5.*",
"utopia-php/storage": "0.18.*",
"utopia-php/swoole": "0.8.*",
diff --git a/composer.lock b/composer.lock
index ff6884de7d..72b460ec52 100644
--- a/composer.lock
+++ b/composer.lock
@@ -4,7 +4,7 @@
"Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
"This file is @generated automatically"
],
- "content-hash": "1557e469b3074a6478a0b2fd522e1a2a",
+ "content-hash": "55bc52686a08d64930e6af7411ac0654",
"packages": [
{
"name": "adhocore/jwt",
@@ -1113,16 +1113,16 @@
},
{
"name": "open-telemetry/api",
- "version": "1.3.0",
+ "version": "1.4.0",
"source": {
"type": "git",
"url": "https://github.com/opentelemetry-php/api.git",
- "reference": "4e3bb38e069876fb73c2ce85c89583bf2b28cd86"
+ "reference": "b3a9286f9c1c8247c83493c5b1fa475cd0cec7f7"
},
"dist": {
"type": "zip",
- "url": "https://api.github.com/repos/opentelemetry-php/api/zipball/4e3bb38e069876fb73c2ce85c89583bf2b28cd86",
- "reference": "4e3bb38e069876fb73c2ce85c89583bf2b28cd86",
+ "url": "https://api.github.com/repos/opentelemetry-php/api/zipball/b3a9286f9c1c8247c83493c5b1fa475cd0cec7f7",
+ "reference": "b3a9286f9c1c8247c83493c5b1fa475cd0cec7f7",
"shasum": ""
},
"require": {
@@ -1142,7 +1142,7 @@
]
},
"branch-alias": {
- "dev-main": "1.1.x-dev"
+ "dev-main": "1.4.x-dev"
}
},
"autoload": {
@@ -1179,7 +1179,7 @@
"issues": "https://github.com/open-telemetry/opentelemetry-php/issues",
"source": "https://github.com/open-telemetry/opentelemetry-php"
},
- "time": "2025-05-07T12:32:21+00:00"
+ "time": "2025-06-19T23:36:51+00:00"
},
{
"name": "open-telemetry/context",
@@ -1242,16 +1242,16 @@
},
{
"name": "open-telemetry/exporter-otlp",
- "version": "1.3.1",
+ "version": "1.3.2",
"source": {
"type": "git",
"url": "https://github.com/opentelemetry-php/exporter-otlp.git",
- "reference": "8b3ca1f86d01429c73b407bf1a2075d9c187001e"
+ "reference": "196f3a1dbce3b2c0f8110d164232c11ac00ddbb2"
},
"dist": {
"type": "zip",
- "url": "https://api.github.com/repos/opentelemetry-php/exporter-otlp/zipball/8b3ca1f86d01429c73b407bf1a2075d9c187001e",
- "reference": "8b3ca1f86d01429c73b407bf1a2075d9c187001e",
+ "url": "https://api.github.com/repos/opentelemetry-php/exporter-otlp/zipball/196f3a1dbce3b2c0f8110d164232c11ac00ddbb2",
+ "reference": "196f3a1dbce3b2c0f8110d164232c11ac00ddbb2",
"shasum": ""
},
"require": {
@@ -1302,7 +1302,7 @@
"issues": "https://github.com/open-telemetry/opentelemetry-php/issues",
"source": "https://github.com/open-telemetry/opentelemetry-php"
},
- "time": "2025-05-21T12:02:20+00:00"
+ "time": "2025-06-16T00:24:51+00:00"
},
{
"name": "open-telemetry/gen-otlp-protobuf",
@@ -1369,22 +1369,22 @@
},
{
"name": "open-telemetry/sdk",
- "version": "1.5.0",
+ "version": "1.6.0",
"source": {
"type": "git",
"url": "https://github.com/opentelemetry-php/sdk.git",
- "reference": "cd0d7367599717fc29e04eb8838ec061e6c2c657"
+ "reference": "1c0371794e4c0700afd4a9d4d8511cb5e3f78e6a"
},
"dist": {
"type": "zip",
- "url": "https://api.github.com/repos/opentelemetry-php/sdk/zipball/cd0d7367599717fc29e04eb8838ec061e6c2c657",
- "reference": "cd0d7367599717fc29e04eb8838ec061e6c2c657",
+ "url": "https://api.github.com/repos/opentelemetry-php/sdk/zipball/1c0371794e4c0700afd4a9d4d8511cb5e3f78e6a",
+ "reference": "1c0371794e4c0700afd4a9d4d8511cb5e3f78e6a",
"shasum": ""
},
"require": {
"ext-json": "*",
"nyholm/psr7-server": "^1.1",
- "open-telemetry/api": "~1.0 || ~1.1",
+ "open-telemetry/api": "~1.4.0",
"open-telemetry/context": "^1.0",
"open-telemetry/sem-conv": "^1.0",
"php": "^8.1",
@@ -1407,6 +1407,10 @@
"type": "library",
"extra": {
"spi": {
+ "OpenTelemetry\\API\\Configuration\\ConfigEnv\\EnvComponentLoader": [
+ "OpenTelemetry\\API\\Instrumentation\\Configuration\\General\\ConfigEnv\\EnvComponentLoaderHttpConfig",
+ "OpenTelemetry\\API\\Instrumentation\\Configuration\\General\\ConfigEnv\\EnvComponentLoaderPeerConfig"
+ ],
"OpenTelemetry\\API\\Instrumentation\\AutoInstrumentation\\HookManagerInterface": [
"OpenTelemetry\\API\\Instrumentation\\AutoInstrumentation\\ExtensionHookManager"
]
@@ -1455,20 +1459,20 @@
"issues": "https://github.com/open-telemetry/opentelemetry-php/issues",
"source": "https://github.com/open-telemetry/opentelemetry-php"
},
- "time": "2025-05-22T02:33:34+00:00"
+ "time": "2025-06-19T23:36:51+00:00"
},
{
"name": "open-telemetry/sem-conv",
- "version": "1.32.0",
+ "version": "1.32.1",
"source": {
"type": "git",
"url": "https://github.com/opentelemetry-php/sem-conv.git",
- "reference": "16585cc0dbc3032a318e274043454679430d2ebf"
+ "reference": "94daa85ea61a8e2b7e1b0af6be0e875bedda7c22"
},
"dist": {
"type": "zip",
- "url": "https://api.github.com/repos/opentelemetry-php/sem-conv/zipball/16585cc0dbc3032a318e274043454679430d2ebf",
- "reference": "16585cc0dbc3032a318e274043454679430d2ebf",
+ "url": "https://api.github.com/repos/opentelemetry-php/sem-conv/zipball/94daa85ea61a8e2b7e1b0af6be0e875bedda7c22",
+ "reference": "94daa85ea61a8e2b7e1b0af6be0e875bedda7c22",
"shasum": ""
},
"require": {
@@ -1512,7 +1516,7 @@
"issues": "https://github.com/open-telemetry/opentelemetry-php/issues",
"source": "https://github.com/open-telemetry/opentelemetry-php"
},
- "time": "2025-05-05T03:58:53+00:00"
+ "time": "2025-06-24T02:32:27+00:00"
},
{
"name": "paragonie/constant_time_encoding",
@@ -1874,16 +1878,16 @@
},
{
"name": "phpseclib/phpseclib",
- "version": "3.0.44",
+ "version": "3.0.46",
"source": {
"type": "git",
"url": "https://github.com/phpseclib/phpseclib.git",
- "reference": "1d0b5e7e1434678411787c5a0535e68907cf82d9"
+ "reference": "56483a7de62a6c2a6635e42e93b8a9e25d4f0ec6"
},
"dist": {
"type": "zip",
- "url": "https://api.github.com/repos/phpseclib/phpseclib/zipball/1d0b5e7e1434678411787c5a0535e68907cf82d9",
- "reference": "1d0b5e7e1434678411787c5a0535e68907cf82d9",
+ "url": "https://api.github.com/repos/phpseclib/phpseclib/zipball/56483a7de62a6c2a6635e42e93b8a9e25d4f0ec6",
+ "reference": "56483a7de62a6c2a6635e42e93b8a9e25d4f0ec6",
"shasum": ""
},
"require": {
@@ -1964,7 +1968,7 @@
],
"support": {
"issues": "https://github.com/phpseclib/phpseclib/issues",
- "source": "https://github.com/phpseclib/phpseclib/tree/3.0.44"
+ "source": "https://github.com/phpseclib/phpseclib/tree/3.0.46"
},
"funding": [
{
@@ -1980,7 +1984,7 @@
"type": "tidelift"
}
],
- "time": "2025-06-15T09:59:26+00:00"
+ "time": "2025-06-26T16:29:55+00:00"
},
{
"name": "psr/container",
@@ -2323,21 +2327,20 @@
},
{
"name": "ramsey/uuid",
- "version": "4.8.1",
+ "version": "4.9.0",
"source": {
"type": "git",
"url": "https://github.com/ramsey/uuid.git",
- "reference": "fdf4dd4e2ff1813111bd0ad58d7a1ddbb5b56c28"
+ "reference": "4e0e23cc785f0724a0e838279a9eb03f28b092a0"
},
"dist": {
"type": "zip",
- "url": "https://api.github.com/repos/ramsey/uuid/zipball/fdf4dd4e2ff1813111bd0ad58d7a1ddbb5b56c28",
- "reference": "fdf4dd4e2ff1813111bd0ad58d7a1ddbb5b56c28",
+ "url": "https://api.github.com/repos/ramsey/uuid/zipball/4e0e23cc785f0724a0e838279a9eb03f28b092a0",
+ "reference": "4e0e23cc785f0724a0e838279a9eb03f28b092a0",
"shasum": ""
},
"require": {
"brick/math": "^0.8.8 || ^0.9 || ^0.10 || ^0.11 || ^0.12 || ^0.13",
- "ext-json": "*",
"php": "^8.0",
"ramsey/collection": "^1.2 || ^2.0"
},
@@ -2396,9 +2399,9 @@
],
"support": {
"issues": "https://github.com/ramsey/uuid/issues",
- "source": "https://github.com/ramsey/uuid/tree/4.8.1"
+ "source": "https://github.com/ramsey/uuid/tree/4.9.0"
},
- "time": "2025-06-01T06:28:46+00:00"
+ "time": "2025-06-25T14:20:11+00:00"
},
{
"name": "spomky-labs/otphp",
@@ -2544,16 +2547,16 @@
},
{
"name": "symfony/http-client",
- "version": "v7.3.0",
+ "version": "v7.3.1",
"source": {
"type": "git",
"url": "https://github.com/symfony/http-client.git",
- "reference": "57e4fb86314015a695a750ace358d07a7e37b8a9"
+ "reference": "4403d87a2c16f33345dca93407a8714ee8c05a64"
},
"dist": {
"type": "zip",
- "url": "https://api.github.com/repos/symfony/http-client/zipball/57e4fb86314015a695a750ace358d07a7e37b8a9",
- "reference": "57e4fb86314015a695a750ace358d07a7e37b8a9",
+ "url": "https://api.github.com/repos/symfony/http-client/zipball/4403d87a2c16f33345dca93407a8714ee8c05a64",
+ "reference": "4403d87a2c16f33345dca93407a8714ee8c05a64",
"shasum": ""
},
"require": {
@@ -2565,6 +2568,7 @@
},
"conflict": {
"amphp/amp": "<2.5",
+ "amphp/socket": "<1.1",
"php-http/discovery": "<1.15",
"symfony/http-foundation": "<6.4"
},
@@ -2577,7 +2581,6 @@
"require-dev": {
"amphp/http-client": "^4.2.1|^5.0",
"amphp/http-tunnel": "^1.0|^2.0",
- "amphp/socket": "^1.1",
"guzzlehttp/promises": "^1.4|^2.0",
"nyholm/psr7": "^1.0",
"php-http/httplug": "^1.0|^2.0",
@@ -2619,7 +2622,7 @@
"http"
],
"support": {
- "source": "https://github.com/symfony/http-client/tree/v7.3.0"
+ "source": "https://github.com/symfony/http-client/tree/v7.3.1"
},
"funding": [
{
@@ -2635,7 +2638,7 @@
"type": "tidelift"
}
],
- "time": "2025-05-02T08:23:16+00:00"
+ "time": "2025-06-28T07:58:39+00:00"
},
{
"name": "symfony/http-client-contracts",
@@ -2957,16 +2960,16 @@
},
{
"name": "tbachert/spi",
- "version": "v1.0.3",
+ "version": "v1.0.5",
"source": {
"type": "git",
"url": "https://github.com/Nevay/spi.git",
- "reference": "506a79c98e1a51522e76ee921ccb6c62d52faf3a"
+ "reference": "e7078767866d0a9e0f91d3f9d42a832df5e39002"
},
"dist": {
"type": "zip",
- "url": "https://api.github.com/repos/Nevay/spi/zipball/506a79c98e1a51522e76ee921ccb6c62d52faf3a",
- "reference": "506a79c98e1a51522e76ee921ccb6c62d52faf3a",
+ "url": "https://api.github.com/repos/Nevay/spi/zipball/e7078767866d0a9e0f91d3f9d42a832df5e39002",
+ "reference": "e7078767866d0a9e0f91d3f9d42a832df5e39002",
"shasum": ""
},
"require": {
@@ -2984,7 +2987,7 @@
"extra": {
"class": "Nevay\\SPI\\Composer\\Plugin",
"branch-alias": {
- "dev-main": "0.2.x-dev"
+ "dev-main": "1.0.x-dev"
},
"plugin-optional": true
},
@@ -3003,9 +3006,9 @@
],
"support": {
"issues": "https://github.com/Nevay/spi/issues",
- "source": "https://github.com/Nevay/spi/tree/v1.0.3"
+ "source": "https://github.com/Nevay/spi/tree/v1.0.5"
},
- "time": "2025-04-02T19:38:14+00:00"
+ "time": "2025-06-29T15:42:06+00:00"
},
{
"name": "thecodingmachine/safe",
@@ -3490,16 +3493,16 @@
},
{
"name": "utopia-php/database",
- "version": "0.71.6",
+ "version": "0.71.9",
"source": {
"type": "git",
"url": "https://github.com/utopia-php/database.git",
- "reference": "2bd87acc40af087fc0fdcccc47c43141dff0be5c"
+ "reference": "eb2f759020bba617e99dd67973a9bd949b47f54e"
},
"dist": {
"type": "zip",
- "url": "https://api.github.com/repos/utopia-php/database/zipball/2bd87acc40af087fc0fdcccc47c43141dff0be5c",
- "reference": "2bd87acc40af087fc0fdcccc47c43141dff0be5c",
+ "url": "https://api.github.com/repos/utopia-php/database/zipball/eb2f759020bba617e99dd67973a9bd949b47f54e",
+ "reference": "eb2f759020bba617e99dd67973a9bd949b47f54e",
"shasum": ""
},
"require": {
@@ -3540,9 +3543,9 @@
],
"support": {
"issues": "https://github.com/utopia-php/database/issues",
- "source": "https://github.com/utopia-php/database/tree/0.71.6"
+ "source": "https://github.com/utopia-php/database/tree/0.71.9"
},
- "time": "2025-06-16T16:48:37+00:00"
+ "time": "2025-07-02T16:37:41+00:00"
},
{
"name": "utopia-php/detector",
@@ -3939,16 +3942,16 @@
},
{
"name": "utopia-php/messaging",
- "version": "0.18.0",
+ "version": "0.18.1",
"source": {
"type": "git",
"url": "https://github.com/utopia-php/messaging.git",
- "reference": "c151aa5d4d475c788ca15c210b5b2017e21c41d6"
+ "reference": "5d1245207a61d7ca065daddad7ac5f1d5640152f"
},
"dist": {
"type": "zip",
- "url": "https://api.github.com/repos/utopia-php/messaging/zipball/c151aa5d4d475c788ca15c210b5b2017e21c41d6",
- "reference": "c151aa5d4d475c788ca15c210b5b2017e21c41d6",
+ "url": "https://api.github.com/repos/utopia-php/messaging/zipball/5d1245207a61d7ca065daddad7ac5f1d5640152f",
+ "reference": "5d1245207a61d7ca065daddad7ac5f1d5640152f",
"shasum": ""
},
"require": {
@@ -3984,22 +3987,22 @@
],
"support": {
"issues": "https://github.com/utopia-php/messaging/issues",
- "source": "https://github.com/utopia-php/messaging/tree/0.18.0"
+ "source": "https://github.com/utopia-php/messaging/tree/0.18.1"
},
- "time": "2025-05-15T05:00:03+00:00"
+ "time": "2025-06-26T18:26:07+00:00"
},
{
"name": "utopia-php/migration",
- "version": "0.10.1",
+ "version": "0.10.4",
"source": {
"type": "git",
"url": "https://github.com/utopia-php/migration.git",
- "reference": "ea1c585df7ec5f346f061a11581fc9a91679966f"
+ "reference": "0c85917482db172b3ccdc0704e42af3c1cc89361"
},
"dist": {
"type": "zip",
- "url": "https://api.github.com/repos/utopia-php/migration/zipball/ea1c585df7ec5f346f061a11581fc9a91679966f",
- "reference": "ea1c585df7ec5f346f061a11581fc9a91679966f",
+ "url": "https://api.github.com/repos/utopia-php/migration/zipball/0c85917482db172b3ccdc0704e42af3c1cc89361",
+ "reference": "0c85917482db172b3ccdc0704e42af3c1cc89361",
"shasum": ""
},
"require": {
@@ -4040,9 +4043,9 @@
],
"support": {
"issues": "https://github.com/utopia-php/migration/issues",
- "source": "https://github.com/utopia-php/migration/tree/0.10.1"
+ "source": "https://github.com/utopia-php/migration/tree/0.10.4"
},
- "time": "2025-05-26T15:29:19+00:00"
+ "time": "2025-07-02T18:31:09+00:00"
},
{
"name": "utopia-php/orchestration",
@@ -4251,16 +4254,16 @@
},
{
"name": "utopia-php/queue",
- "version": "0.11.1",
+ "version": "0.11.0",
"source": {
"type": "git",
"url": "https://github.com/utopia-php/queue.git",
- "reference": "498bbbef418b1db71b51e1bb62f5d1d752ddd8d6"
+ "reference": "06b5ced0eaed2ecc6aab6d8e1b4d96bff37a1ce5"
},
"dist": {
"type": "zip",
- "url": "https://api.github.com/repos/utopia-php/queue/zipball/498bbbef418b1db71b51e1bb62f5d1d752ddd8d6",
- "reference": "498bbbef418b1db71b51e1bb62f5d1d752ddd8d6",
+ "url": "https://api.github.com/repos/utopia-php/queue/zipball/06b5ced0eaed2ecc6aab6d8e1b4d96bff37a1ce5",
+ "reference": "06b5ced0eaed2ecc6aab6d8e1b4d96bff37a1ce5",
"shasum": ""
},
"require": {
@@ -4311,9 +4314,9 @@
],
"support": {
"issues": "https://github.com/utopia-php/queue/issues",
- "source": "https://github.com/utopia-php/queue/tree/0.11.1"
+ "source": "https://github.com/utopia-php/queue/tree/0.11.0"
},
- "time": "2025-05-30T11:50:34+00:00"
+ "time": "2025-05-30T09:52:38+00:00"
},
{
"name": "utopia-php/registry",
@@ -4807,16 +4810,16 @@
"packages-dev": [
{
"name": "appwrite/sdk-generator",
- "version": "0.41.7",
+ "version": "0.41.11",
"source": {
"type": "git",
"url": "https://github.com/appwrite/sdk-generator.git",
- "reference": "d8c7bb26ea32ab378faf4e0dfa62fd15fe37c57b"
+ "reference": "60122cb613a5a1c82667ecc2217e351654a8d404"
},
"dist": {
"type": "zip",
- "url": "https://api.github.com/repos/appwrite/sdk-generator/zipball/d8c7bb26ea32ab378faf4e0dfa62fd15fe37c57b",
- "reference": "d8c7bb26ea32ab378faf4e0dfa62fd15fe37c57b",
+ "url": "https://api.github.com/repos/appwrite/sdk-generator/zipball/60122cb613a5a1c82667ecc2217e351654a8d404",
+ "reference": "60122cb613a5a1c82667ecc2217e351654a8d404",
"shasum": ""
},
"require": {
@@ -4852,9 +4855,9 @@
"description": "Appwrite PHP library for generating API SDKs for multiple programming languages and platforms",
"support": {
"issues": "https://github.com/appwrite/sdk-generator/issues",
- "source": "https://github.com/appwrite/sdk-generator/tree/0.41.7"
+ "source": "https://github.com/appwrite/sdk-generator/tree/0.41.11"
},
- "time": "2025-06-13T17:05:57+00:00"
+ "time": "2025-07-04T09:56:24+00:00"
},
{
"name": "doctrine/annotations",
@@ -5081,16 +5084,16 @@
},
{
"name": "laravel/pint",
- "version": "v1.22.1",
+ "version": "v1.23.0",
"source": {
"type": "git",
"url": "https://github.com/laravel/pint.git",
- "reference": "941d1927c5ca420c22710e98420287169c7bcaf7"
+ "reference": "9ab851dba4faa51a3c3223dd3d07044129021024"
},
"dist": {
"type": "zip",
- "url": "https://api.github.com/repos/laravel/pint/zipball/941d1927c5ca420c22710e98420287169c7bcaf7",
- "reference": "941d1927c5ca420c22710e98420287169c7bcaf7",
+ "url": "https://api.github.com/repos/laravel/pint/zipball/9ab851dba4faa51a3c3223dd3d07044129021024",
+ "reference": "9ab851dba4faa51a3c3223dd3d07044129021024",
"shasum": ""
},
"require": {
@@ -5101,10 +5104,10 @@
"php": "^8.2.0"
},
"require-dev": {
- "friendsofphp/php-cs-fixer": "^3.75.0",
- "illuminate/view": "^11.44.7",
- "larastan/larastan": "^3.4.0",
- "laravel-zero/framework": "^11.36.1",
+ "friendsofphp/php-cs-fixer": "^3.76.0",
+ "illuminate/view": "^11.45.1",
+ "larastan/larastan": "^3.5.0",
+ "laravel-zero/framework": "^11.45.0",
"mockery/mockery": "^1.6.12",
"nunomaduro/termwind": "^2.3.1",
"pestphp/pest": "^2.36.0"
@@ -5114,6 +5117,9 @@
],
"type": "project",
"autoload": {
+ "files": [
+ "overrides/Runner/Parallel/ProcessFactory.php"
+ ],
"psr-4": {
"App\\": "app/",
"Database\\Seeders\\": "database/seeders/",
@@ -5143,20 +5149,20 @@
"issues": "https://github.com/laravel/pint/issues",
"source": "https://github.com/laravel/pint"
},
- "time": "2025-05-08T08:38:12+00:00"
+ "time": "2025-07-03T10:37:47+00:00"
},
{
"name": "matthiasmullie/minify",
- "version": "1.3.74",
+ "version": "1.3.75",
"source": {
"type": "git",
"url": "https://github.com/matthiasmullie/minify.git",
- "reference": "a2593286a4135d03c6a6a9e9aeded5d41e931ce4"
+ "reference": "76ba4a5f555fd7bf4aa408af608e991569076671"
},
"dist": {
"type": "zip",
- "url": "https://api.github.com/repos/matthiasmullie/minify/zipball/a2593286a4135d03c6a6a9e9aeded5d41e931ce4",
- "reference": "a2593286a4135d03c6a6a9e9aeded5d41e931ce4",
+ "url": "https://api.github.com/repos/matthiasmullie/minify/zipball/76ba4a5f555fd7bf4aa408af608e991569076671",
+ "reference": "76ba4a5f555fd7bf4aa408af608e991569076671",
"shasum": ""
},
"require": {
@@ -5205,7 +5211,7 @@
],
"support": {
"issues": "https://github.com/matthiasmullie/minify/issues",
- "source": "https://github.com/matthiasmullie/minify/tree/1.3.74"
+ "source": "https://github.com/matthiasmullie/minify/tree/1.3.75"
},
"funding": [
{
@@ -5213,7 +5219,7 @@
"type": "github"
}
],
- "time": "2025-06-12T08:06:04+00:00"
+ "time": "2025-06-25T09:56:19+00:00"
},
{
"name": "matthiasmullie/path-converter",
@@ -7252,16 +7258,16 @@
},
{
"name": "symfony/console",
- "version": "v7.3.0",
+ "version": "v7.3.1",
"source": {
"type": "git",
"url": "https://github.com/symfony/console.git",
- "reference": "66c1440edf6f339fd82ed6c7caa76cb006211b44"
+ "reference": "9e27aecde8f506ba0fd1d9989620c04a87697101"
},
"dist": {
"type": "zip",
- "url": "https://api.github.com/repos/symfony/console/zipball/66c1440edf6f339fd82ed6c7caa76cb006211b44",
- "reference": "66c1440edf6f339fd82ed6c7caa76cb006211b44",
+ "url": "https://api.github.com/repos/symfony/console/zipball/9e27aecde8f506ba0fd1d9989620c04a87697101",
+ "reference": "9e27aecde8f506ba0fd1d9989620c04a87697101",
"shasum": ""
},
"require": {
@@ -7326,7 +7332,7 @@
"terminal"
],
"support": {
- "source": "https://github.com/symfony/console/tree/v7.3.0"
+ "source": "https://github.com/symfony/console/tree/v7.3.1"
},
"funding": [
{
@@ -7342,7 +7348,7 @@
"type": "tidelift"
}
],
- "time": "2025-05-24T10:34:04+00:00"
+ "time": "2025-06-27T19:55:54+00:00"
},
{
"name": "symfony/filesystem",
diff --git a/docker-compose.yml b/docker-compose.yml
index 0b653af8c2..a01165d949 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -116,6 +116,7 @@ services:
- _APP_OPTIONS_ROUTER_FORCE_HTTPS
- _APP_OPENSSL_KEY_V1
- _APP_DOMAIN
+ - _APP_CONSOLE_DOMAIN
- _APP_DOMAIN_TARGET_CNAME
- _APP_DOMAIN_TARGET_AAAA
- _APP_DOMAIN_TARGET_A
@@ -213,7 +214,7 @@ services:
appwrite-console:
<<: *x-logging
container_name: appwrite-console
- image: appwrite/console:6.0.41
+ image: appwrite/console:6.1.2
restart: unless-stopped
networks:
- appwrite
@@ -323,7 +324,8 @@ services:
depends_on:
- redis
- mariadb
- - request-catcher
+ - request-catcher-sms
+ - request-catcher-webhook
environment:
- _APP_ENV
- _APP_WORKER_PER_CORE
@@ -481,6 +483,7 @@ services:
- _APP_OPTIONS_FORCE_HTTPS
- _APP_OPTIONS_ROUTER_FORCE_HTTPS
- _APP_DOMAIN
+ - _APP_CONSOLE_DOMAIN
- _APP_STORAGE_DEVICE
- _APP_STORAGE_S3_ACCESS_KEY
- _APP_STORAGE_S3_SECRET
@@ -951,7 +954,7 @@ services:
hostname: exc1
<<: *x-logging
stop_signal: SIGINT
- image: openruntimes/executor:0.7.20
+ image: openruntimes/executor:0.7.22
restart: unless-stopped
networks:
- appwrite
@@ -1075,15 +1078,24 @@ services:
networks:
- appwrite
- request-catcher: # used mainly for dev tests
+ request-catcher-webhook: # used mainly for dev tests (mock HTTP webhook)
image: appwrite/requestcatcher:1.0.0
- container_name: appwrite-requestcatcher
+ container_name: appwrite-requestcatcher-webhook
<<: *x-logging
ports:
- "9504:5000"
networks:
- appwrite
+ request-catcher-sms: # used mainly for dev tests (mock SMS auth secret)
+ image: appwrite/requestcatcher:1.0.0
+ container_name: appwrite-requestcatcher-sms
+ <<: *x-logging
+ ports:
+ - "9507:5000"
+ networks:
+ - appwrite
+
adminer:
image: adminer
container_name: appwrite-adminer
diff --git a/docs/examples/1.7.x/console-cli/examples/proxy/create-redirect-rule.md b/docs/examples/1.7.x/console-cli/examples/proxy/create-redirect-rule.md
index f975ce686e..ec9098a748 100644
--- a/docs/examples/1.7.x/console-cli/examples/proxy/create-redirect-rule.md
+++ b/docs/examples/1.7.x/console-cli/examples/proxy/create-redirect-rule.md
@@ -1,4 +1,6 @@
appwrite proxy createRedirectRule \
--domain '' \
--url https://example.com \
- --statusCode 301
+ --statusCode 301 \
+ --resourceId \
+ --resourceType site
diff --git a/docs/examples/1.7.x/console-cli/examples/vcs/get-repository-contents.md b/docs/examples/1.7.x/console-cli/examples/vcs/get-repository-contents.md
index 7d378d7efa..3ba8d75c91 100644
--- a/docs/examples/1.7.x/console-cli/examples/vcs/get-repository-contents.md
+++ b/docs/examples/1.7.x/console-cli/examples/vcs/get-repository-contents.md
@@ -2,3 +2,4 @@ appwrite vcs getRepositoryContents \
--installationId \
--providerRepositoryId \
+
diff --git a/docs/references/databases/create-documents.md b/docs/references/databases/create-documents.md
index a02d7c8bf1..7f60c138ea 100644
--- a/docs/references/databases/create-documents.md
+++ b/docs/references/databases/create-documents.md
@@ -1 +1,3 @@
+**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.
+
Create new Documents. Before using this route, you should create a new collection resource using either a [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection) API or directly from your database console.
\ No newline at end of file
diff --git a/docs/references/databases/delete-documents.md b/docs/references/databases/delete-documents.md
index a7b05503de..b4e255c69f 100644
--- a/docs/references/databases/delete-documents.md
+++ b/docs/references/databases/delete-documents.md
@@ -1 +1,3 @@
+**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.
+
Bulk delete documents using queries, if no queries are passed then all documents are deleted.
\ No newline at end of file
diff --git a/docs/references/databases/update-documents.md b/docs/references/databases/update-documents.md
index 5f560c6435..9ab8373d36 100644
--- a/docs/references/databases/update-documents.md
+++ b/docs/references/databases/update-documents.md
@@ -1 +1,3 @@
+**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.
+
Update all documents that match your queries, if no queries are submitted then all documents are updated. You can pass only specific fields to be updated.
\ No newline at end of file
diff --git a/docs/references/databases/upsert-document.md b/docs/references/databases/upsert-document.md
index a67694cfa6..1980141d22 100644
--- a/docs/references/databases/upsert-document.md
+++ b/docs/references/databases/upsert-document.md
@@ -1 +1,3 @@
+**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.
+
Create or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection) API or directly from your database console.
\ No newline at end of file
diff --git a/docs/references/databases/upsert-documents.md b/docs/references/databases/upsert-documents.md
index f46254bd7b..2e2dc461ba 100644
--- a/docs/references/databases/upsert-documents.md
+++ b/docs/references/databases/upsert-documents.md
@@ -1 +1,3 @@
-Create or update Documents. Before using this route, you should create a new collection resource using either a [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection) API or directly from your database console.
+**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.
+
+Create or update Documents. Before using this route, you should create a new collection resource using either a [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection) API or directly from your database console.
\ No newline at end of file
diff --git a/docs/references/vcs/get-repository-contents.md b/docs/references/vcs/get-repository-contents.md
index ab5ef7f8da..176b4203d3 100644
--- a/docs/references/vcs/get-repository-contents.md
+++ b/docs/references/vcs/get-repository-contents.md
@@ -1 +1 @@
-Get a list of files and directories from a GitHub repository connected to your project. This endpoint returns the contents of a specified repository path, including file names, sizes, and whether each item is a file or directory. The GitHub installation must be properly configured and the repository must be accessible through your installation for this endpoint to work.
+Get a list of files and directories from a GitHub repository connected to your project. This endpoint returns the contents of a specified repository path, including file names, sizes, and whether each item is a file or directory. The GitHub installation must be properly configured and the repository must be accessible through your installation for this endpoint to work.
\ No newline at end of file
diff --git a/docs/sdks/cli/CHANGELOG.md b/docs/sdks/cli/CHANGELOG.md
index fa4d35e687..c2c93b0c09 100644
--- a/docs/sdks/cli/CHANGELOG.md
+++ b/docs/sdks/cli/CHANGELOG.md
@@ -1 +1,61 @@
-# Change Log
\ No newline at end of file
+# Change Log
+
+## 8.1.0
+
+* Add multi-region support to `init` command
+* Update `init` command to clear previous configuration in `appwrite.json`
+* Update localConfig to store multi-region endpoint
+* Fix throw error when creating unknown attribute instead of timing out
+* Fix equal comparison of large numbers and BigNumber instances using proper equality checks
+* Fix duplication of reasons when comparing localConfig with remoteConfig
+* Fix `firstOrNull()` to `firstOrNull` in types generation for dart
+* Refactor to use `isCloud()` method consistently
+
+## 8.0.2
+
+* Add Type generation fixes:
+ * Properly handle enum attributes in dart, java and kotlin
+ * Fix initialisation of null attributes in dart's fromMap method
+ * Fix relationships and enums in swift
+
+## 8.0.1
+
+* Add `resourceId` and `resourceType` attributes to `createRedirectRule`
+* Add `providerReference` to vcs command for getting repository contents
+* Add warning comment to `bulk updateDocuments` method
+* Fix type generation for enums in Typescript and PHP language
+
+## 8.0.0
+
+* Add `types` command to generate language specific typings for collections. Currently supports - `php`, `swift`, `dart`, `js`, `ts`, `kotlin` and `java`
+* Update bulk operation docs to include experiment feature warnings
+* Remove assistant service and commands
+
+## 7.0.0
+
+* Add `sites` command
+* Add `tokens` command
+* Add `devKeys` support to `projects` command
+* Add `init site`, `pull site` and `push site` commands
+* Add bulk operation methods like `createDocuments`, `deleteDocuments` etc.
+* Add new upsert methods: `upsertDocument` and `upsertDocuments`
+* Update GET requests to not include content-type header
+
+## 6.2.3
+
+* Fix hot swapping error in `python-ml` function
+
+## 6.2.2
+
+* Fix GitHub builds by adding `qemu-system` package
+* Fix attribute creation timed out
+
+## 6.2.1
+
+* Add `listOrganizations` method to `organizations` service and fix init project command
+
+## 6.2.0
+
+* Add specifications support to CLI
+* Update package version
+* Fix: Missed specifications param when updating a function
\ No newline at end of file
diff --git a/docs/sdks/react-native/CHANGELOG.md b/docs/sdks/react-native/CHANGELOG.md
index 1bc7d89373..56e176f08f 100644
--- a/docs/sdks/react-native/CHANGELOG.md
+++ b/docs/sdks/react-native/CHANGELOG.md
@@ -1,5 +1,18 @@
# Change log
+## 0.10.0
+
+* Add generate file URL methods like`getFilePreviewURL`, `getFileViewURL` etc.
+* Update (breaking) existing methods like `getFilePreview` to download the image instead of returning URLs
+
+## 0.9.2
+
+* Fix `devKeys` by removing credentials from requests when the key is set
+
+## 0.9.1
+
+* Add `setDevkey` and `upsertDocument` methods
+
## 0.9.0
* Add `token` param to `getFilePreview` and `getFileView` for File tokens usage
diff --git a/src/Appwrite/Event/Database.php b/src/Appwrite/Event/Database.php
index d2f70dddf2..70051f9055 100644
--- a/src/Appwrite/Event/Database.php
+++ b/src/Appwrite/Event/Database.php
@@ -10,8 +10,15 @@ class Database extends Event
{
protected string $type = '';
protected ?Document $database = null;
- protected ?Document $collection = null;
+
+ // tables api
+ protected ?Document $row = null;
+ protected ?Document $table = null;
+
+ // collections api
protected ?Document $document = null;
+ protected ?Document $collection = null;
+
public function __construct(protected Publisher $publisher)
{
@@ -54,6 +61,61 @@ class Database extends Event
return $this;
}
+ /**
+ * Returns set database for this event.
+ *
+ * @return null|Document
+ */
+ public function getDatabase(): ?Document
+ {
+ return $this->database;
+ }
+
+ /**
+ * Set the table for this database event.
+ *
+ * @param Document $table
+ * @return self
+ */
+ public function setTable(Document $table): self
+ {
+ $this->table = $table;
+
+ return $this;
+ }
+
+ /**
+ * Returns set table for this event.
+ *
+ * @return null|Document
+ */
+ public function getTable(): ?Document
+ {
+ return $this->table;
+ }
+
+ /**
+ * Set the row for this database event.
+ *
+ * @param Document $row
+ * @return self
+ */
+ public function setRow(Document $row): self
+ {
+ $this->row = $row;
+
+ return $this;
+ }
+
+ /**
+ * Returns set row for this database event.
+ * @return null|Document
+ */
+ public function getRow(): ?Document
+ {
+ return $this->row;
+ }
+
/**
* Set the collection for this database event.
*
@@ -123,6 +185,8 @@ class Database extends Event
'project' => $this->project,
'user' => $this->user,
'type' => $this->type,
+ 'table' => $this->table,
+ 'row' => $this->row,
'collection' => $this->collection,
'document' => $this->document,
'database' => $this->database,
diff --git a/src/Appwrite/Event/Event.php b/src/Appwrite/Event/Event.php
index 934647f7c3..2c38811022 100644
--- a/src/Appwrite/Event/Event.php
+++ b/src/Appwrite/Event/Event.php
@@ -569,7 +569,12 @@ class Event
/**
* Force a non-assoc array.
*/
- return \array_values($events);
+ $eventValues = \array_values($events);
+
+ /**
+ * Return a combined list of table, collection events.
+ */
+ return Event::mirrorCollectionEvents($pattern, $eventValues[0], $eventValues);
}
/**
@@ -590,4 +595,45 @@ class Event
$this->context = $event->context;
return $this;
}
+
+ /**
+ * Adds `table` events for `collection` events.
+ *
+ * Example:
+ *
+ * `databases.*.collections.*.documents.*.update` →\
+ * `[databases.*.collections.*.documents.*.update, databases.*.tables.*.rows.*.update]`
+ */
+ private static function mirrorCollectionEvents(string $pattern, string $firstEvent, array $events): array
+ {
+ $tableEventMap = [
+ 'documents' => 'rows',
+ 'collections' => 'tables',
+ 'attributes' => 'columns',
+ ];
+
+ if (
+ str_contains($pattern, 'databases.') &&
+ str_contains($firstEvent, 'collections')
+ ) {
+ $pairedEvents = [];
+
+ foreach ($events as $event) {
+ $pairedEvents[] = $event;
+
+ if (str_contains($event, 'collections')) {
+ $tableSideEvent = str_replace(
+ array_keys($tableEventMap),
+ array_values($tableEventMap),
+ $event
+ );
+ $pairedEvents[] = $tableSideEvent;
+ }
+ }
+
+ $events = $pairedEvents;
+ }
+
+ return $events;
+ }
}
diff --git a/src/Appwrite/Event/Realtime.php b/src/Appwrite/Event/Realtime.php
index 4d8c9a321b..6cb51ffa14 100644
--- a/src/Appwrite/Event/Realtime.php
+++ b/src/Appwrite/Event/Realtime.php
@@ -73,19 +73,21 @@ class Realtime extends Event
}
$allEvents = Event::generateEvents($this->getEvent(), $this->getParams());
+
$payload = new Document($this->getPayload());
$db = $this->getContext('database');
- $collection = $this->getContext('collection');
$bucket = $this->getContext('bucket');
+ // Can be Tables API or Collections API; generated channels include both!
+ $tableOrCollection = $this->getContext('table') ?? $this->getContext('collection');
+
$target = RealtimeAdapter::fromPayload(
- // Pass first, most verbose event pattern
event: $allEvents[0],
payload: $payload,
project: $this->getProject(),
database: $db,
- collection: $collection,
+ collection: $tableOrCollection,
bucket: $bucket,
);
diff --git a/src/Appwrite/Extend/Exception.php b/src/Appwrite/Extend/Exception.php
index 3af6d9962c..8eded2dbe0 100644
--- a/src/Appwrite/Extend/Exception.php
+++ b/src/Appwrite/Extend/Exception.php
@@ -48,7 +48,8 @@ class Exception extends \Exception
public const GENERAL_SMTP_DISABLED = 'general_smtp_disabled';
public const GENERAL_PHONE_DISABLED = 'general_phone_disabled';
public const GENERAL_ARGUMENT_INVALID = 'general_argument_invalid';
- public const GENERAL_QUERY_LIMIT_EXCEEDED = 'general_query_limit_exceeded';
+ public const GENERAL_COLUMN_QUERY_LIMIT_EXCEEDED = 'general_column_query_limit_exceeded';
+ public const GENERAL_ATTRIBUTE_QUERY_LIMIT_EXCEEDED = 'general_attribute_query_limit_exceeded';
public const GENERAL_QUERY_INVALID = 'general_query_invalid';
public const GENERAL_ROUTE_NOT_FOUND = 'general_route_not_found';
public const GENERAL_CURSOR_NOT_FOUND = 'general_cursor_not_found';
@@ -198,6 +199,11 @@ class Exception extends \Exception
public const COLLECTION_ALREADY_EXISTS = 'collection_already_exists';
public const COLLECTION_LIMIT_EXCEEDED = 'collection_limit_exceeded';
+ /** Tables */
+ public const TABLE_NOT_FOUND = 'table_not_found';
+ public const TABLE_ALREADY_EXISTS = 'table_already_exists';
+ public const TABLE_LIMIT_EXCEEDED = 'table_limit_exceeded';
+
/** Documents */
public const DOCUMENT_NOT_FOUND = 'document_not_found';
public const DOCUMENT_INVALID_STRUCTURE = 'document_invalid_structure';
@@ -207,7 +213,16 @@ class Exception extends \Exception
public const DOCUMENT_UPDATE_CONFLICT = 'document_update_conflict';
public const DOCUMENT_DELETE_RESTRICTED = 'document_delete_restricted';
- /** Attribute */
+ /** Rows */
+ public const ROW_NOT_FOUND = 'row_not_found';
+ public const ROW_INVALID_STRUCTURE = 'row_invalid_structure';
+ public const ROW_MISSING_DATA = 'row_missing_data';
+ public const ROW_MISSING_PAYLOAD = 'row_missing_payload';
+ public const ROW_ALREADY_EXISTS = 'row_already_exists';
+ public const ROW_UPDATE_CONFLICT = 'row_update_conflict';
+ public const ROW_DELETE_RESTRICTED = 'row_delete_restricted';
+
+ /** Attributes */
public const ATTRIBUTE_NOT_FOUND = 'attribute_not_found';
public const ATTRIBUTE_UNKNOWN = 'attribute_unknown';
public const ATTRIBUTE_NOT_AVAILABLE = 'attribute_not_available';
@@ -219,6 +234,18 @@ class Exception extends \Exception
public const ATTRIBUTE_TYPE_INVALID = 'attribute_type_invalid';
public const ATTRIBUTE_INVALID_RESIZE = 'attribute_invalid_resize';
+ /** Columns */
+ public const COLUMN_NOT_FOUND = 'column_not_found';
+ public const COLUMN_UNKNOWN = 'column_unknown';
+ public const COLUMN_NOT_AVAILABLE = 'column_not_available';
+ public const COLUMN_FORMAT_UNSUPPORTED = 'column_format_unsupported';
+ public const COLUMN_DEFAULT_UNSUPPORTED = 'column_default_unsupported';
+ public const COLUMN_ALREADY_EXISTS = 'column_already_exists';
+ public const COLUMN_LIMIT_EXCEEDED = 'column_limit_exceeded';
+ public const COLUMN_VALUE_INVALID = 'column_value_invalid';
+ public const COLUMN_TYPE_INVALID = 'column_type_invalid';
+ public const COLUMN_INVALID_RESIZE = 'column_invalid_resize';
+
/** Relationship */
public const RELATIONSHIP_VALUE_INVALID = 'relationship_value_invalid';
@@ -229,6 +256,13 @@ class Exception extends \Exception
public const INDEX_INVALID = 'index_invalid';
public const INDEX_DEPENDENCY = 'index_dependency';
+ /** Column Indexes */
+ public const COLUMN_INDEX_NOT_FOUND = 'column_index_not_found';
+ public const COLUMN_INDEX_LIMIT_EXCEEDED = 'column_index_limit_exceeded';
+ public const COLUMN_INDEX_ALREADY_EXISTS = 'column_index_already_exists';
+ public const COLUMN_INDEX_INVALID = 'column_index_invalid';
+ public const COLUMN_INDEX_DEPENDENCY = 'column_index_dependency';
+
/** Projects */
public const PROJECT_NOT_FOUND = 'project_not_found';
public const PROJECT_PROVIDER_DISABLED = 'project_provider_disabled';
@@ -316,7 +350,7 @@ class Exception extends \Exception
public const MESSAGE_MISSING_SCHEDULE = 'message_missing_schedule';
/** Targets */
- public const TARGET_PROVIDER_INVALID_TYPE = 'target_provider_invalid_type';
+ public const TARGET_PROVIDER_INVALID_TYPE = 'target_provider_invalid_type';
/** Schedules */
public const SCHEDULE_NOT_FOUND = 'schedule_not_found';
diff --git a/src/Appwrite/GraphQL/Types/Mapper.php b/src/Appwrite/GraphQL/Types/Mapper.php
index 3c7915bc96..66f3508104 100644
--- a/src/Appwrite/GraphQL/Types/Mapper.php
+++ b/src/Appwrite/GraphQL/Types/Mapper.php
@@ -226,7 +226,7 @@ class Mapper
];
if (!$rule['required']) {
- $fields[$escapedKey]['defaultValue'] = $rule['default'];
+ $fields[$escapedKey]['defaultValue'] = $rule['default'] ?? null;
}
}
@@ -290,7 +290,9 @@ class Mapper
case 'Utopia\Database\Validator\Authorization':
case 'Appwrite\Utopia\Database\Validator\Queries\Base':
case 'Appwrite\Utopia\Database\Validator\Queries\Buckets':
+ case 'Appwrite\Utopia\Database\Validator\Queries\Tables':
case 'Appwrite\Utopia\Database\Validator\Queries\Collections':
+ case 'Appwrite\Utopia\Database\Validator\Queries\Columns':
case 'Appwrite\Utopia\Database\Validator\Queries\Attributes':
case 'Appwrite\Utopia\Database\Validator\Queries\Indexes':
case 'Appwrite\Utopia\Database\Validator\Queries\Databases':
@@ -425,7 +427,9 @@ class Mapper
switch ($name) {
case 'Attributes':
- return static::getAttributeImplementation($object);
+ return static::getColumnImplementation($object);
+ case 'Columns':
+ return static::getColumnImplementation($object, true);
case 'HashOptions':
return static::getHashOptionsImplementation($object);
}
@@ -433,29 +437,24 @@ class Mapper
throw new Exception('Unknown union type: ' . $name);
}
- private static function getAttributeImplementation(array $object): Type
+ private static function getColumnImplementation(array $object, bool $isColumns = false): Type
{
- switch ($object['type']) {
- case 'string':
- return match ($object['format'] ?? '') {
- 'email' => static::model('AttributeEmail'),
- 'url' => static::model('AttributeUrl'),
- 'ip' => static::model('AttributeIp'),
- default => static::model('AttributeString'),
- };
- case 'integer':
- return static::model('AttributeInteger');
- case 'double':
- return static::model('AttributeFloat');
- case 'boolean':
- return static::model('AttributeBoolean');
- case 'datetime':
- return static::model('AttributeDatetime');
- case 'relationship':
- return static::model('AttributeRelationship');
- }
+ $prefix = $isColumns ? 'Column' : 'Attribute';
- throw new Exception('Unknown attribute implementation');
+ return match ($object['type']) {
+ 'string' => match ($object['format'] ?? '') {
+ 'email' => static::model("{$prefix}Email"),
+ 'url' => static::model("{$prefix}Url"),
+ 'ip' => static::model("{$prefix}Ip"),
+ default => static::model("{$prefix}String"),
+ },
+ 'integer' => static::model("{$prefix}Integer"),
+ 'double' => static::model("{$prefix}Float"),
+ 'boolean' => static::model("{$prefix}Boolean"),
+ 'datetime' => static::model("{$prefix}Datetime"),
+ 'relationship' => static::model("{$prefix}Relationship"),
+ default => throw new Exception('Unknown ' . strtolower($prefix) . ' implementation'),
+ };
}
private static function getHashOptionsImplementation(array $object): Type
diff --git a/src/Appwrite/Messaging/Adapter/Realtime.php b/src/Appwrite/Messaging/Adapter/Realtime.php
index d122841d68..8b5e121dcd 100644
--- a/src/Appwrite/Messaging/Adapter/Realtime.php
+++ b/src/Appwrite/Messaging/Adapter/Realtime.php
@@ -230,7 +230,7 @@ class Realtime extends MessagingAdapter
foreach ($channels as $key => $value) {
switch (true) {
- case \str_starts_with($key, 'account.'):
+ case str_starts_with($key, 'account.'):
unset($channels[$key]);
break;
@@ -273,6 +273,7 @@ class Realtime extends MessagingAdapter
$roles = [Role::user(ID::custom($parts[1]))->toString()];
break;
case 'rules':
+ case 'migrations':
$channels[] = 'console';
$channels[] = 'projects.' . $project->getId();
$projectId = 'console';
@@ -297,19 +298,24 @@ class Realtime extends MessagingAdapter
$roles = [Role::team(ID::custom($parts[1]))->toString()];
break;
case 'databases':
- if (in_array($parts[4] ?? [], ['attributes', 'indexes'])) {
+ $resource = $parts[4] ?? '';
+ if (in_array($resource, ['columns', 'attributes', 'indexes'])) {
$channels[] = 'console';
$channels[] = 'projects.' . $project->getId();
$projectId = 'console';
$roles = [Role::team($project->getAttribute('teamId'))->toString()];
- } elseif (($parts[4] ?? '') === 'documents') {
+ } elseif (in_array($resource, ['rows', 'documents'])) {
if ($database->isEmpty()) {
- throw new \Exception('Database needs to be passed to Realtime for Document events in the Database.');
+ throw new \Exception('Database needs to be passed to Realtime for Document/Row events in the Database.');
}
if ($collection->isEmpty()) {
- throw new \Exception('Collection needs to be passed to Realtime for Document events in the Database.');
+ throw new \Exception('Collection or the Table needs to be passed to Realtime for Document/Row events in the Database.');
}
+ $channels[] = 'rows';
+ $channels[] = 'databases.' . $database->getId() . '.tables.' . $payload->getAttribute('$tableId') . '.rows';
+ $channels[] = 'databases.' . $database->getId() . '.tables.' . $payload->getAttribute('$tableId') . '.rows.' . $payload->getId();
+
$channels[] = 'documents';
$channels[] = 'databases.' . $database->getId() . '.collections.' . $payload->getAttribute('$collectionId') . '.documents';
$channels[] = 'databases.' . $database->getId() . '.collections.' . $payload->getAttribute('$collectionId') . '.documents.' . $payload->getId();
@@ -334,7 +340,6 @@ class Realtime extends MessagingAdapter
}
break;
-
case 'functions':
if ($parts[2] === 'executions') {
if (!empty($payload->getRead())) {
@@ -361,12 +366,6 @@ class Realtime extends MessagingAdapter
$roles = [Role::team($project->getAttribute('teamId'))->toString()];
}
break;
- case 'migrations':
- $channels[] = 'console';
- $channels[] = 'projects.' . $project->getId();
- $projectId = 'console';
- $roles = [Role::team($project->getAttribute('teamId'))->toString()];
- break;
}
return [
diff --git a/src/Appwrite/Network/Platform.php b/src/Appwrite/Network/Platform.php
new file mode 100644
index 0000000000..d584ec074f
--- /dev/null
+++ b/src/Appwrite/Network/Platform.php
@@ -0,0 +1,151 @@
+ Map scheme types to user-friendly platform names.
+ */
+ private static array $names = [
+ self::SCHEME_HTTP => 'Web',
+ self::SCHEME_HTTPS => 'Web',
+ self::SCHEME_IOS => 'iOS',
+ self::SCHEME_MACOS => 'macOS',
+ self::SCHEME_WATCHOS => 'watchOS',
+ self::SCHEME_TVOS => 'tvOS',
+ self::SCHEME_ANDROID => 'Android',
+ self::SCHEME_WINDOWS => 'Windows',
+ self::SCHEME_LINUX => 'Linux',
+ ];
+
+ /**
+ * Get user-friendly platform name from a scheme.
+ *
+ * @param string|null $scheme
+ * @return string Empty string if scheme is not found.
+ */
+ public static function getNameByScheme(?string $scheme): string
+ {
+ return self::$names[$scheme] ?? '';
+ }
+
+ public static function getHostnames(array $platforms): array
+ {
+ $hostnames = [];
+ foreach ($platforms as $platform) {
+ $type = strtolower($platform['type'] ?? self::TYPE_UNKNOWN);
+ $hostname = strtolower($platform['hostname'] ?? '');
+ $key = strtolower($platform['key'] ?? '');
+
+ switch ($type) {
+ case self::TYPE_WEB:
+ case self::TYPE_FLUTTER_WEB:
+ if (!empty($hostname)) {
+ $hostnames[] = $hostname;
+ }
+ break;
+ case self::TYPE_FLUTTER_IOS:
+ case self::TYPE_FLUTTER_ANDROID:
+ case self::TYPE_FLUTTER_MACOS:
+ case self::TYPE_FLUTTER_WINDOWS:
+ case self::TYPE_FLUTTER_LINUX:
+ case self::TYPE_ANDROID:
+ case self::TYPE_APPLE_IOS:
+ case self::TYPE_APPLE_MACOS:
+ case self::TYPE_APPLE_WATCHOS:
+ case self::TYPE_APPLE_TVOS:
+ case self::TYPE_REACT_NATIVE_IOS:
+ case self::TYPE_REACT_NATIVE_ANDROID:
+ case self::TYPE_UNITY:
+ if (!empty($key)) {
+ $hostnames[] = $key;
+ }
+ break;
+ default:
+ break;
+ }
+ }
+ return array_unique($hostnames);
+ }
+
+ public static function getSchemes(array $platforms): array
+ {
+ $schemes = [];
+ foreach ($platforms as $platform) {
+ $type = strtolower($platform['type'] ?? self::TYPE_UNKNOWN);
+ $scheme = strtolower($platform['key'] ?? '');
+
+ switch ($type) {
+ case self::TYPE_SCHEME:
+ if (!empty($scheme) && preg_match('/^[a-z][a-z0-9+.-]*$/', $scheme)) {
+ $schemes[] = $scheme;
+ }
+ break;
+ case self::TYPE_WEB:
+ case self::TYPE_FLUTTER_WEB:
+ $schemes[] = self::SCHEME_HTTP;
+ $schemes[] = self::SCHEME_HTTPS;
+ break;
+ case self::TYPE_FLUTTER_IOS:
+ case self::TYPE_APPLE_IOS:
+ case self::TYPE_REACT_NATIVE_IOS:
+ $schemes[] = self::SCHEME_IOS;
+ break;
+ case self::TYPE_FLUTTER_ANDROID:
+ case self::TYPE_ANDROID:
+ case self::TYPE_REACT_NATIVE_ANDROID:
+ $schemes[] = self::SCHEME_ANDROID;
+ break;
+ case self::TYPE_FLUTTER_MACOS:
+ case self::TYPE_APPLE_MACOS:
+ $schemes[] = self::SCHEME_MACOS;
+ break;
+ case self::TYPE_FLUTTER_WINDOWS:
+ case self::TYPE_UNITY:
+ $schemes[] = self::SCHEME_WINDOWS;
+ break;
+ case self::TYPE_FLUTTER_LINUX:
+ $schemes[] = self::SCHEME_LINUX;
+ break;
+ case self::TYPE_APPLE_WATCHOS:
+ $schemes[] = self::SCHEME_WATCHOS;
+ break;
+ case self::TYPE_APPLE_TVOS:
+ $schemes[] = self::SCHEME_TVOS;
+ break;
+ default:
+ break;
+ }
+ }
+ return array_unique($schemes);
+ }
+}
diff --git a/src/Appwrite/Network/Validator/Origin.php b/src/Appwrite/Network/Validator/Origin.php
index d41e9af2ad..c8d9ee626d 100644
--- a/src/Appwrite/Network/Validator/Origin.php
+++ b/src/Appwrite/Network/Validator/Origin.php
@@ -2,150 +2,77 @@
namespace Appwrite\Network\Validator;
+use Appwrite\Network\Platform;
use Utopia\Validator;
use Utopia\Validator\Hostname;
class Origin extends Validator
{
- public const CLIENT_TYPE_UNKNOWN = 'unknown';
- public const CLIENT_TYPE_WEB = 'web';
- public const CLIENT_TYPE_FLUTTER_IOS = 'flutter-ios';
- public const CLIENT_TYPE_FLUTTER_ANDROID = 'flutter-android';
- public const CLIENT_TYPE_FLUTTER_MACOS = 'flutter-macos';
- public const CLIENT_TYPE_FLUTTER_WINDOWS = 'flutter-windows';
- public const CLIENT_TYPE_FLUTTER_LINUX = 'flutter-linux';
- public const CLIENT_TYPE_FLUTTER_WEB = 'flutter-web';
- public const CLIENT_TYPE_APPLE_IOS = 'apple-ios';
- public const CLIENT_TYPE_APPLE_MACOS = 'apple-macos';
- public const CLIENT_TYPE_APPLE_WATCHOS = 'apple-watchos';
- public const CLIENT_TYPE_APPLE_TVOS = 'apple-tvos';
- public const CLIENT_TYPE_ANDROID = 'android';
- public const CLIENT_TYPE_UNITY = 'unity';
- public const CLIENT_TYPE_REACT_NATIVE_IOS = 'react-native-ios';
- public const CLIENT_TYPE_REACT_NATIVE_ANDROID = 'react-native-android';
-
-
- public const SCHEME_TYPE_HTTP = 'http';
- public const SCHEME_TYPE_HTTPS = 'https';
- public const SCHEME_TYPE_IOS = 'appwrite-ios';
- public const SCHEME_TYPE_MACOS = 'appwrite-macos';
- public const SCHEME_TYPE_WATCHOS = 'appwrite-watchos';
- public const SCHEME_TYPE_TVOS = 'appwrite-tvos';
- public const SCHEME_TYPE_ANDROID = 'appwrite-android';
- public const SCHEME_TYPE_WINDOWS = 'appwrite-windows';
- public const SCHEME_TYPE_LINUX = 'appwrite-linux';
+ protected array $hostnames = [];
+ protected array $schemes = [];
+ protected ?string $scheme = null;
+ protected ?string $host = null;
/**
- * @var array
+ * Constructor
+ *
+ * @param array<\Utopia\Database\Document> $platforms
*/
- protected $platforms = [
- self::SCHEME_TYPE_HTTP => 'Web',
- self::SCHEME_TYPE_HTTPS => 'Web',
- self::SCHEME_TYPE_IOS => 'iOS',
- self::SCHEME_TYPE_MACOS => 'macOS',
- self::SCHEME_TYPE_WATCHOS => 'watchOS',
- self::SCHEME_TYPE_TVOS => 'tvOS',
- self::SCHEME_TYPE_ANDROID => 'Android',
- self::SCHEME_TYPE_WINDOWS => 'Windows',
- self::SCHEME_TYPE_LINUX => 'Linux',
- ];
-
- /**
- * @var array
- */
- protected $clients = [
- ];
-
- /**
- * @var string
- */
- protected $client = self::CLIENT_TYPE_UNKNOWN;
-
- /**
- * @var string
- */
- protected $host = '';
-
- /**
- * @param string $target
- */
- public function __construct($platforms)
+ public function __construct(array $platforms)
{
- foreach ($platforms as $platform) {
- $type = (isset($platform['type'])) ? $platform['type'] : '';
-
- switch ($type) {
- case self::CLIENT_TYPE_WEB:
- case self::CLIENT_TYPE_FLUTTER_WEB:
- $this->clients[] = (isset($platform['hostname'])) ? $platform['hostname'] : '';
- break;
-
- case self::CLIENT_TYPE_FLUTTER_IOS:
- case self::CLIENT_TYPE_FLUTTER_ANDROID:
- case self::CLIENT_TYPE_FLUTTER_MACOS:
- case self::CLIENT_TYPE_FLUTTER_WINDOWS:
- case self::CLIENT_TYPE_FLUTTER_LINUX:
- case self::CLIENT_TYPE_ANDROID:
- case self::CLIENT_TYPE_APPLE_IOS:
- case self::CLIENT_TYPE_APPLE_MACOS:
- case self::CLIENT_TYPE_APPLE_WATCHOS:
- case self::CLIENT_TYPE_APPLE_TVOS:
- case self::CLIENT_TYPE_REACT_NATIVE_IOS:
- case self::CLIENT_TYPE_REACT_NATIVE_ANDROID:
- $this->clients[] = (isset($platform['key'])) ? $platform['key'] : '';
- break;
-
- default:
- # code...
- break;
- }
- }
+ $this->hostnames = Platform::getHostnames($platforms);
+ $this->schemes = Platform::getSchemes($platforms);
}
- public function getDescription(): string
- {
- if (!\array_key_exists($this->client, $this->platforms)) {
- return 'Unsupported platform';
- }
-
- return 'Invalid Origin. Register your new client (' . $this->host . ') as a new '
- . $this->platforms[$this->client] . ' platform on your project console dashboard';
- }
/**
- * Check if Origin has been allowed
- * for access to the API
- *
- * @param mixed $origin
- *
+ * Check if Origin is valid.
+ * @param mixed $origin The Origin URI.
* @return bool
*/
public function isValid($origin): bool
{
- if (!is_string($origin)) {
+ $this->scheme = null;
+ $this->host = null;
+
+ if (!is_string($origin) || empty($origin)) {
return false;
}
- $scheme = \parse_url($origin, PHP_URL_SCHEME);
- $host = \parse_url($origin, PHP_URL_HOST);
+ $this->scheme = $this->parseScheme($origin);
+ $this->host = strtolower(parse_url($origin, PHP_URL_HOST) ?? '');
- $this->host = $host;
- $this->client = $scheme;
+ if (in_array($this->scheme, [Platform::SCHEME_HTTP, Platform::SCHEME_HTTPS], true)) {
+ $validator = new Hostname($this->hostnames);
+ return $validator->isValid($this->host);
+ }
- if (empty($host)) {
+ if (!empty($this->scheme) && in_array($this->scheme, $this->schemes, true)) {
return true;
}
- $validator = new Hostname($this->clients);
+ return false;
+ }
- return $validator->isValid($host);
+ /**
+ * Get Description
+ * @return string
+ */
+ public function getDescription(): string
+ {
+ $platform = $this->scheme ? Platform::getNameByScheme($this->scheme) : null;
+ $host = $this->host ? '(' . $this->host . ')' : '';
+
+ if (empty($this->host) && empty($this->scheme)) {
+ return 'Invalid Origin.';
+ }
+
+ return 'Invalid Origin. Register your new client ' . $host . ' as a new '
+ . $platform . ' platform on your project console dashboard';
}
/**
* Is array
- *
- * Function will return true if object is array.
- *
* @return bool
*/
public function isArray(): bool
@@ -155,13 +82,35 @@ class Origin extends Validator
/**
* Get Type
- *
- * Returns validator type.
- *
* @return string
*/
public function getType(): string
{
return self::TYPE_STRING;
}
+
+ /**
+ * Parses the scheme from a URI string.
+ *
+ * @param string $uri The URI string to parse.
+ * @return string|null The extracted scheme string (e.g., "http", "exp", "mailto")
+ */
+ public function parseScheme(string $uri): ?string
+ {
+ $uri = trim($uri);
+ if ($uri === '') {
+ return null; // No scheme in empty string
+ }
+
+ $scheme = parse_url($uri, PHP_URL_SCHEME);
+ if ($scheme === false) {
+ if (preg_match('/^([a-z][a-z0-9+.-]*):/i', $uri, $matches)) {
+ return $matches[1];
+ } else {
+ return null;
+ }
+ } else {
+ return $scheme;
+ }
+ }
}
diff --git a/src/Appwrite/Network/Validator/Redirect.php b/src/Appwrite/Network/Validator/Redirect.php
new file mode 100644
index 0000000000..162f4c7eb9
--- /dev/null
+++ b/src/Appwrite/Network/Validator/Redirect.php
@@ -0,0 +1,25 @@
+scheme);
+ $host = $this->host ? '(' . $this->host . ')' : '';
+
+ if (empty($this->host) && empty($this->scheme)) {
+ return 'Invalid URI.';
+ }
+
+ return 'Invalid URI. Register your new client ' . $host . ' as a new '
+ . $platform . ' platform on your project console dashboard';
+ }
+}
diff --git a/src/Appwrite/Platform/Action.php b/src/Appwrite/Platform/Action.php
index 72c41582ea..e5a7cf7984 100644
--- a/src/Appwrite/Platform/Action.php
+++ b/src/Appwrite/Platform/Action.php
@@ -3,7 +3,10 @@
namespace Appwrite\Platform;
use Swoole\Coroutine as Co;
+use Utopia\CLI\Console;
use Utopia\Database\Database;
+use Utopia\Database\DateTime;
+use Utopia\Database\Document;
use Utopia\Database\Query;
use Utopia\Platform\Action as UtopiaAction;
@@ -16,6 +19,12 @@ class Action extends UtopiaAction
*/
protected mixed $logError;
+ protected array $filters = [
+ 'subQueryKeys', 'subQueryWebhooks', 'subQueryPlatforms', 'subQueryProjectVariables', 'subQueryBlocks', 'subQueryDevKeys', // Project
+ 'subQueryAuthenticators', 'subQuerySessions', 'subQueryTokens', 'subQueryChallenges', 'subQueryMemberships', 'subQueryTargets', 'subQueryTopicTargets',// Users
+ 'subQueryVariables', // Sites
+ ];
+
/**
* Foreach Document
* Call provided callback for each document in the collection
@@ -87,4 +96,57 @@ class Action extends UtopiaAction
$latestDocument = $results[array_key_last($results)];
}
}
+
+ public function disableSubqueries()
+ {
+ $filters = $this->filters;
+
+ foreach ($filters as $filter) {
+ Database::addFilter(
+ $filter,
+ function (mixed $value) {
+ return;
+ },
+ function (mixed $value, Document $document, Database $database) {
+ return [];
+ }
+ );
+ }
+ }
+
+ /**
+ * Dump Log Message
+ *
+ * Logs messages to console with timestamp, method context, and project details.
+ * Supports multiple log types: success, error, log, warning, and info (default).
+ *
+ * @param string $method The calling method name
+ * @param string $log The log message
+ * @param string $type The log type (success, error, log, warning, info)
+ * @param Document|null $project The project document for context
+ * @param string $collectionId The collection identifier
+ * @return void
+ */
+ public function dump(string $method, string $log, string $type = 'info', ?Document $project = null, string $collectionId = ''): void
+ {
+ if (empty($project)) {
+ $project = new Document([]);
+ }
+ switch ($type) {
+ case 'success':
+ Console::success("[" . DateTime::now() . "] " . $method . ' ' . $type . ' ' . $project->getSequence() . ' ' . $project->getId() . ' ' . $collectionId . ' ' . $log);
+ break;
+ case 'error':
+ Console::error("[" . DateTime::now() . "] " . $method . ' ' . $type . ' ' . $project->getSequence() . ' ' . $project->getId() . ' ' . $collectionId . ' ' . $log);
+ break;
+ case 'log':
+ Console::log("[" . DateTime::now() . "] " . $method . ' ' . $type . ' ' . $project->getSequence() . ' ' . $project->getId() . ' ' . $collectionId . ' ' . $log);
+ break;
+ case 'warning':
+ Console::warning("[" . DateTime::now() . "] " . $method . ' ' . $type . ' ' . $project->getSequence() . ' ' . $project->getId() . ' ' . $collectionId . ' ' . $log);
+ break;
+ default:
+ Console::info("[" . DateTime::now() . "] " . $method . ' ' . $type . ' ' . $project->getSequence() . ' ' . $project->getId() . ' ' . $collectionId . ' ' . $log);
+ }
+ }
}
diff --git a/src/Appwrite/Platform/Appwrite.php b/src/Appwrite/Platform/Appwrite.php
index 5752432257..a77f894be7 100644
--- a/src/Appwrite/Platform/Appwrite.php
+++ b/src/Appwrite/Platform/Appwrite.php
@@ -4,6 +4,7 @@ namespace Appwrite\Platform;
use Appwrite\Platform\Modules\Console;
use Appwrite\Platform\Modules\Core;
+use Appwrite\Platform\Modules\Databases;
use Appwrite\Platform\Modules\Functions;
use Appwrite\Platform\Modules\Projects;
use Appwrite\Platform\Modules\Proxy;
@@ -16,6 +17,7 @@ class Appwrite extends Platform
public function __construct()
{
parent::__construct(new Core());
+ $this->addModule(new Databases\Module());
$this->addModule(new Projects\Module());
$this->addModule(new Functions\Module());
$this->addModule(new Sites\Module());
diff --git a/src/Appwrite/Platform/Modules/Compute/Base.php b/src/Appwrite/Platform/Modules/Compute/Base.php
index fe4a267cd7..e58f2b8664 100644
--- a/src/Appwrite/Platform/Modules/Compute/Base.php
+++ b/src/Appwrite/Platform/Modules/Compute/Base.php
@@ -6,6 +6,7 @@ use Appwrite\Event\Build;
use Appwrite\Extend\Exception;
use Utopia\Database\Database;
use Utopia\Database\Document;
+use Utopia\Database\Exception\Duplicate;
use Utopia\Database\Helpers\ID;
use Utopia\Database\Helpers\Permission;
use Utopia\Database\Helpers\Role;
@@ -226,6 +227,73 @@ class Base extends Action
]))
);
+ if (!empty($commitDetails['commitHash'])) {
+ $domain = "commit-" . substr($commitDetails['commitHash'], 0, 16) . ".{$sitesDomain}";
+ $ruleId = md5($domain);
+ try {
+ Authorization::skip(
+ fn () => $dbForPlatform->createDocument('rules', new Document([
+ '$id' => $ruleId,
+ 'projectId' => $project->getId(),
+ 'projectInternalId' => $project->getSequence(),
+ 'domain' => $domain,
+ 'type' => 'deployment',
+ 'trigger' => 'deployment',
+ 'deploymentId' => $deployment->getId(),
+ 'deploymentInternalId' => $deployment->getSequence(),
+ 'deploymentResourceType' => 'site',
+ 'deploymentResourceId' => $site->getId(),
+ 'deploymentResourceInternalId' => $site->getSequence(),
+ 'deploymentVcsProviderBranch' => $providerBranch,
+ 'status' => 'verified',
+ 'certificateId' => '',
+ 'search' => implode(' ', [$ruleId, $domain]),
+ 'owner' => 'Appwrite',
+ 'region' => $project->getAttribute('region')
+ ]))
+ );
+ } catch (Duplicate $err) {
+ // Ignore, rule already exists; will be updated by builds worker
+ }
+ }
+
+ // VCS branch preview
+ if (!empty($providerBranch)) {
+ $branchPrefix = substr($providerBranch, 0, 16);
+ if (strlen($providerBranch) > 16) {
+ $remainingChars = substr($providerBranch, 16);
+ $branchPrefix .= '-' . substr(hash('sha256', $remainingChars), 0, 7);
+ }
+ $resourceProjectHash = substr(hash('sha256', $site->getId() . $project->getId()), 0, 7);
+ $domain = "branch-{$branchPrefix}-{$resourceProjectHash}.{$sitesDomain}";
+ $ruleId = md5($domain);
+ try {
+ Authorization::skip(
+ fn () => $dbForPlatform->createDocument('rules', new Document([
+ '$id' => $ruleId,
+ 'projectId' => $project->getId(),
+ 'projectInternalId' => $project->getSequence(),
+ 'domain' => $domain,
+ 'type' => 'deployment',
+ 'trigger' => 'deployment',
+ 'deploymentId' => $deployment->getId(),
+ 'deploymentInternalId' => $deployment->getSequence(),
+ 'deploymentResourceType' => 'site',
+ 'deploymentResourceId' => $site->getId(),
+ 'deploymentResourceInternalId' => $site->getSequence(),
+ 'deploymentVcsProviderBranch' => $providerBranch,
+ 'status' => 'verified',
+ 'certificateId' => '',
+ 'search' => implode(' ', [$ruleId, $domain]),
+ 'owner' => 'Appwrite',
+ 'region' => $project->getAttribute('region')
+ ]))
+ );
+ } catch (Duplicate $err) {
+ // Ignore, rule already exists; will be updated by builds worker
+ }
+ }
+
$queueForBuilds
->setType(BUILD_TYPE_DEPLOYMENT)
->setResource($site)
diff --git a/src/Appwrite/Platform/Modules/Console/Http/Resources/Get.php b/src/Appwrite/Platform/Modules/Console/Http/Resources/Get.php
index 16a94dc00c..114a24ef22 100644
--- a/src/Appwrite/Platform/Modules/Console/Http/Resources/Get.php
+++ b/src/Appwrite/Platform/Modules/Console/Http/Resources/Get.php
@@ -57,7 +57,7 @@ class Get extends Action
->param('type', '', new WhiteList(['rules']), 'Resource type.')
->inject('response')
->inject('dbForPlatform')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Databases/Constants.php b/src/Appwrite/Platform/Modules/Databases/Constants.php
new file mode 100644
index 0000000000..cfc297c3f4
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Constants.php
@@ -0,0 +1,24 @@
+context = TABLES;
+ }
+
+ return parent::setHttpPath($path);
+ }
+
+ /**
+ * Get the current API context.
+ */
+ final protected function getContext(): string
+ {
+ return $this->context;
+ }
+
+ /**
+ * Get the key used in event parameters (e.g., 'collectionId' or 'tableId').
+ */
+ final protected function getEventsParamKey(): string
+ {
+ return $this->getContext() . 'Id';
+ }
+
+ /**
+ * Determine if the current action is for the Collections API.
+ */
+ final protected function isCollectionsAPI(): bool
+ {
+ return $this->getContext() === COLLECTIONS;
+ }
+
+ /**
+ * Get the SDK group name for the current action.
+ */
+ final protected function getSdkGroup(): string
+ {
+ return $this->isCollectionsAPI() ? 'collections' : 'tables';
+ }
+
+ /**
+ * Get the SDK namespace for the current action.
+ */
+ final protected function getSdkNamespace(): string
+ {
+ return $this->isCollectionsAPI() ? 'databases' : 'tables';
+ }
+
+ /**
+ * Get the exception to throw when the resource already exists.
+ */
+ final protected function getDuplicateException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::COLLECTION_ALREADY_EXISTS
+ : Exception::TABLE_ALREADY_EXISTS;
+ }
+
+ /**
+ * Get the appropriate index invalid exception.
+ */
+ final protected function getInvalidIndexException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::INDEX_INVALID
+ : Exception::COLUMN_INDEX_INVALID;
+ }
+
+ /**
+ * Get the exception to throw when the resource is not found.
+ */
+ final protected function getNotFoundException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::COLLECTION_NOT_FOUND
+ : Exception::TABLE_NOT_FOUND;
+ }
+
+ /**
+ * Get the exception to throw when the resource limit is exceeded.
+ */
+ final protected function getLimitException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::COLLECTION_LIMIT_EXCEEDED
+ : Exception::TABLE_LIMIT_EXCEEDED;
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Action.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Action.php
new file mode 100644
index 0000000000..3f331edc9a
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Action.php
@@ -0,0 +1,646 @@
+context = COLUMNS;
+ }
+
+ return parent::setHttpPath($path);
+ }
+
+ /**
+ * Get the current context.
+ */
+ final protected function getContext(): string
+ {
+ return $this->context;
+ }
+
+ /**
+ * Returns true if current context is Collections API.
+ */
+ final protected function isCollectionsAPI(): bool
+ {
+ // columns in tables context
+ // attributes in collections context
+ return $this->getContext() === ATTRIBUTES;
+ }
+
+ /**
+ * Get the SDK group name for the current action.
+ *
+ * Can be used for XList operations as well!
+ */
+ final protected function getSdkGroup(): string
+ {
+ return $this->isCollectionsAPI() ? 'attributes' : 'columns';
+ }
+
+ /**
+ * Get the SDK namespace for the current action.
+ */
+ final protected function getSdkNamespace(): string
+ {
+ return $this->isCollectionsAPI() ? 'databases' : 'tables';
+ }
+
+ /**
+ * Get the appropriate parent level not found exception.
+ */
+ final protected function getParentNotFoundException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::COLLECTION_NOT_FOUND
+ : Exception::TABLE_NOT_FOUND;
+ }
+
+ /**
+ * Get the appropriate not found exception.
+ */
+ final protected function getNotFoundException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::ATTRIBUTE_NOT_FOUND
+ : Exception::COLUMN_NOT_FOUND;
+ }
+
+ /**
+ * Get the appropriate not found exception.
+ */
+ final protected function getIndexDependencyException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::INDEX_DEPENDENCY
+ : Exception::COLUMN_INDEX_DEPENDENCY;
+ }
+
+ /**
+ * Get the appropriate already exists exception.
+ */
+ final protected function getDuplicateException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::ATTRIBUTE_ALREADY_EXISTS
+ : Exception::COLUMN_ALREADY_EXISTS;
+ }
+
+ /**
+ * Get the correct invalid structure message.
+ */
+ final protected function getInvalidStructureException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::DOCUMENT_INVALID_STRUCTURE
+ : Exception::ROW_INVALID_STRUCTURE;
+ }
+
+ /**
+ * Get the appropriate limit exceeded exception.
+ */
+ final protected function getLimitException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::ATTRIBUTE_LIMIT_EXCEEDED
+ : Exception::COLUMN_LIMIT_EXCEEDED;
+ }
+
+ /**
+ * Get the appropriate index invalid exception.
+ */
+ final protected function getInvalidIndexException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::INDEX_INVALID
+ : Exception::COLUMN_INDEX_INVALID;
+ }
+
+ /**
+ * Get the correct default unsupported message.
+ */
+ final protected function getDefaultUnsupportedException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::ATTRIBUTE_DEFAULT_UNSUPPORTED
+ : Exception::COLUMN_DEFAULT_UNSUPPORTED;
+ }
+
+ /**
+ * Get the correct format unsupported message.
+ */
+ final protected function getFormatUnsupportedException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::ATTRIBUTE_FORMAT_UNSUPPORTED
+ : Exception::COLUMN_FORMAT_UNSUPPORTED;
+ }
+
+ /**
+ * Get the exception for invalid type or format mismatch.
+ */
+ final protected function getTypeInvalidException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::ATTRIBUTE_TYPE_INVALID
+ : Exception::COLUMN_TYPE_INVALID;
+ }
+
+ /**
+ * Get the exception for resizing invalid attributes/columns.
+ */
+ final protected function getInvalidResizeException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::ATTRIBUTE_INVALID_RESIZE
+ : Exception::COLUMN_INVALID_RESIZE;
+ }
+
+ /**
+ * Get the exception for invalid attributes/columns value.
+ */
+ final protected function getInvalidValueException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::ATTRIBUTE_VALUE_INVALID
+ : Exception::COLUMN_VALUE_INVALID;
+ }
+
+ /**
+ * Get the exception for non-available column/attribute.
+ */
+ final protected function getNotAvailableException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::ATTRIBUTE_NOT_AVAILABLE
+ : Exception::COLUMN_NOT_AVAILABLE;
+ }
+
+ /**
+ * Get the correct collections context for Events queue.
+ */
+ final protected function getCollectionsEventsContext(): string
+ {
+ return $this->isCollectionsAPI() ? 'collection' : 'table';
+ }
+
+ /**
+ * Get the proper column/attribute type based on set context.
+ */
+ final protected function getModel(string $type, string $format): string
+ {
+ $isCollections = $this->isCollectionsAPI();
+
+ return match ($type) {
+ Database::VAR_BOOLEAN => $isCollections
+ ? UtopiaResponse::MODEL_ATTRIBUTE_BOOLEAN
+ : UtopiaResponse::MODEL_COLUMN_BOOLEAN,
+
+ Database::VAR_INTEGER => $isCollections
+ ? UtopiaResponse::MODEL_ATTRIBUTE_INTEGER
+ : UtopiaResponse::MODEL_COLUMN_INTEGER,
+
+ Database::VAR_FLOAT => $isCollections
+ ? UtopiaResponse::MODEL_ATTRIBUTE_FLOAT
+ : UtopiaResponse::MODEL_COLUMN_FLOAT,
+
+ Database::VAR_DATETIME => $isCollections
+ ? UtopiaResponse::MODEL_ATTRIBUTE_DATETIME
+ : UtopiaResponse::MODEL_COLUMN_DATETIME,
+
+ Database::VAR_RELATIONSHIP => $isCollections
+ ? UtopiaResponse::MODEL_ATTRIBUTE_RELATIONSHIP
+ : UtopiaResponse::MODEL_COLUMN_RELATIONSHIP,
+
+ Database::VAR_STRING => match ($format) {
+ APP_DATABASE_ATTRIBUTE_EMAIL => $isCollections
+ ? UtopiaResponse::MODEL_ATTRIBUTE_EMAIL
+ : UtopiaResponse::MODEL_COLUMN_EMAIL,
+
+ APP_DATABASE_ATTRIBUTE_ENUM => $isCollections
+ ? UtopiaResponse::MODEL_ATTRIBUTE_ENUM
+ : UtopiaResponse::MODEL_COLUMN_ENUM,
+
+ APP_DATABASE_ATTRIBUTE_IP => $isCollections
+ ? UtopiaResponse::MODEL_ATTRIBUTE_IP
+ : UtopiaResponse::MODEL_COLUMN_IP,
+
+ APP_DATABASE_ATTRIBUTE_URL => $isCollections
+ ? UtopiaResponse::MODEL_ATTRIBUTE_URL
+ : UtopiaResponse::MODEL_COLUMN_URL,
+
+ default => $isCollections
+ ? UtopiaResponse::MODEL_ATTRIBUTE_STRING
+ : UtopiaResponse::MODEL_COLUMN_STRING,
+ },
+ default => $isCollections
+ ? UtopiaResponse::MODEL_ATTRIBUTE
+ : UtopiaResponse::MODEL_COLUMN,
+ };
+ }
+
+ final protected function createAttribute(string $databaseId, string $collectionId, Document $attribute, Response $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents): Document
+ {
+ $key = $attribute->getAttribute('key');
+ $type = $attribute->getAttribute('type', '');
+ $size = $attribute->getAttribute('size', 0);
+ $required = $attribute->getAttribute('required', true);
+ $signed = $attribute->getAttribute('signed', true); // integers are signed by default
+ $array = $attribute->getAttribute('array', false);
+ $format = $attribute->getAttribute('format', '');
+ $formatOptions = $attribute->getAttribute('formatOptions', []);
+ $filters = $attribute->getAttribute('filters', []); // filters are hidden from the endpoint
+ $default = $attribute->getAttribute('default');
+ $options = $attribute->getAttribute('options', []);
+
+ $db = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
+
+ if ($db->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $collection = $dbForProject->getDocument('database_' . $db->getSequence(), $collectionId);
+
+ if ($collection->isEmpty()) {
+ throw new Exception($this->getParentNotFoundException());
+ }
+
+ if (!empty($format)) {
+ if (!Structure::hasFormat($format, $type)) {
+ throw new Exception($this->getFormatUnsupportedException(), "Format $format not available for $type columns.");
+ }
+ }
+
+ // Must throw here since dbForProject->createAttribute is performed by db worker
+ if ($required && isset($default)) {
+ throw new Exception($this->getDefaultUnsupportedException(), 'Cannot set default value for required ' . $this->getContext());
+ }
+
+ if ($array && isset($default)) {
+ throw new Exception($this->getDefaultUnsupportedException(), 'Cannot set default value for array ' . $this->getContext() . 's');
+ }
+
+ if ($type === Database::VAR_RELATIONSHIP) {
+ $options['side'] = Database::RELATION_SIDE_PARENT;
+ $relatedCollection = $dbForProject->getDocument('database_' . $db->getSequence(), $options['relatedCollection'] ?? '');
+ if ($relatedCollection->isEmpty()) {
+ $parent = $this->isCollectionsAPI() ? 'collection' : 'table';
+ throw new Exception($this->getParentNotFoundException(), "The related $parent was not found.");
+ }
+ }
+
+ try {
+ $attribute = new Document([
+ '$id' => ID::custom($db->getSequence() . '_' . $collection->getSequence() . '_' . $key),
+ 'key' => $key,
+ 'databaseInternalId' => $db->getSequence(),
+ 'databaseId' => $db->getId(),
+ 'collectionInternalId' => $collection->getSequence(),
+ 'collectionId' => $collectionId,
+ 'type' => $type,
+ 'status' => 'processing', // processing, available, failed, deleting, stuck
+ 'size' => $size,
+ 'required' => $required,
+ 'signed' => $signed,
+ 'default' => $default,
+ 'array' => $array,
+ 'format' => $format,
+ 'formatOptions' => $formatOptions,
+ 'filters' => $filters,
+ 'options' => $options,
+ ]);
+
+ $dbForProject->checkAttribute($collection, $attribute);
+ $attribute = $dbForProject->createDocument('attributes', $attribute);
+ } catch (DuplicateException) {
+ throw new Exception($this->getDuplicateException());
+ } catch (LimitException) {
+ throw new Exception($this->getLimitException());
+ } catch (Throwable $e) {
+ $dbForProject->purgeCachedDocument('database_' . $db->getSequence(), $collectionId);
+ $dbForProject->purgeCachedCollection('database_' . $db->getSequence() . '_collection_' . $collection->getSequence());
+ throw $e;
+ }
+
+ $dbForProject->purgeCachedDocument('database_' . $db->getSequence(), $collectionId);
+ $dbForProject->purgeCachedCollection('database_' . $db->getSequence() . '_collection_' . $collection->getSequence());
+
+ if ($type === Database::VAR_RELATIONSHIP && $options['twoWay']) {
+ $twoWayKey = $options['twoWayKey'];
+ $options['relatedCollection'] = $collection->getId();
+ $options['twoWayKey'] = $key;
+ $options['side'] = Database::RELATION_SIDE_CHILD;
+
+ try {
+ $twoWayAttribute = new Document([
+ '$id' => ID::custom($db->getSequence() . '_' . $relatedCollection->getSequence() . '_' . $twoWayKey),
+ 'key' => $twoWayKey,
+ 'databaseInternalId' => $db->getSequence(),
+ 'databaseId' => $db->getId(),
+ 'collectionInternalId' => $relatedCollection->getSequence(),
+ 'collectionId' => $relatedCollection->getId(),
+ 'type' => $type,
+ 'status' => 'processing', // processing, available, failed, deleting, stuck
+ 'size' => $size,
+ 'required' => $required,
+ 'signed' => $signed,
+ 'default' => $default,
+ 'array' => $array,
+ 'format' => $format,
+ 'formatOptions' => $formatOptions,
+ 'filters' => $filters,
+ 'options' => $options,
+ ]);
+
+ $dbForProject->checkAttribute($relatedCollection, $twoWayAttribute);
+ $dbForProject->createDocument('attributes', $twoWayAttribute);
+ } catch (DuplicateException) {
+ throw new Exception($this->getDuplicateException());
+ } catch (LimitException) {
+ throw new Exception($this->getLimitException());
+ } catch (StructureException) {
+ throw new Exception($this->getInvalidStructureException());
+ } catch (Throwable $e) {
+ $dbForProject->deleteDocument('attributes', $attribute->getId());
+ throw $e;
+ } finally {
+ $dbForProject->purgeCachedDocument('database_' . $db->getSequence(), $collectionId);
+ $dbForProject->purgeCachedCollection('database_' . $db->getSequence() . '_collection_' . $collection->getSequence());
+ }
+
+ // If operation succeeded, purge the cache for the related collection too
+ $dbForProject->purgeCachedDocument('database_' . $db->getSequence(), $relatedCollection->getId());
+ $dbForProject->purgeCachedCollection('database_' . $db->getSequence() . '_collection_' . $relatedCollection->getSequence());
+ }
+
+ $queueForDatabase
+ ->setType(DATABASE_TYPE_CREATE_ATTRIBUTE)
+ ->setDatabase($db);
+
+ if ($this->isCollectionsAPI()) {
+ $queueForDatabase
+ ->setDocument($attribute)
+ ->setCollection($collection);
+ } else {
+ $queueForDatabase
+ ->setRow($attribute)
+ ->setTable($collection);
+ }
+
+ $queueForEvents
+ ->setContext('database', $db)
+ ->setParam('databaseId', $databaseId)
+ ->setParam('collectionId', $collection->getId())
+ ->setParam('tableId', $collection->getId())
+ ->setParam('attributeId', $attribute->getId())
+ ->setParam('columnId', $attribute->getId())
+ ->setContext($this->getCollectionsEventsContext(), $collection);
+
+ $response->setStatusCode(SwooleResponse::STATUS_CODE_CREATED);
+
+ return $attribute;
+ }
+
+ final protected function updateAttribute(string $databaseId, string $collectionId, string $key, Database $dbForProject, Event $queueForEvents, string $type, int $size = null, string $filter = null, string|bool|int|float $default = null, bool $required = null, int|float|null $min = null, int|float|null $max = null, array $elements = null, array $options = [], string $newKey = null): Document
+ {
+ $db = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
+
+ if ($db->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $collection = $dbForProject->getDocument('database_' . $db->getSequence(), $collectionId);
+
+ if ($collection->isEmpty()) {
+ throw new Exception($this->getParentNotFoundException());
+ }
+
+ $attribute = $dbForProject->getDocument('attributes', $db->getSequence() . '_' . $collection->getSequence() . '_' . $key);
+
+ if ($attribute->isEmpty()) {
+ throw new Exception($this->getNotFoundException());
+ }
+
+ if ($attribute->getAttribute('status') !== 'available') {
+ throw new Exception($this->getNotAvailableException());
+ }
+
+ if ($attribute->getAttribute(('type') !== $type)) {
+ throw new Exception($this->getTypeInvalidException());
+ }
+
+ if ($attribute->getAttribute('type') === Database::VAR_STRING && $attribute->getAttribute(('filter') !== $filter)) {
+ throw new Exception($this->getTypeInvalidException());
+ }
+
+ if ($required && isset($default)) {
+ throw new Exception($this->getDefaultUnsupportedException(), 'Cannot set default value for required ' . $this->getContext());
+ }
+
+ if ($attribute->getAttribute('array', false) && isset($default)) {
+ throw new Exception($this->getDefaultUnsupportedException(), 'Cannot set default value for array ' . $this->getContext() . 's');
+ }
+
+ $collectionId = 'database_' . $db->getSequence() . '_collection_' . $collection->getSequence();
+
+ $attribute
+ ->setAttribute('default', $default)
+ ->setAttribute('required', $required);
+
+ if (!empty($size)) {
+ $attribute->setAttribute('size', $size);
+ }
+
+ switch ($attribute->getAttribute('format')) {
+ case APP_DATABASE_ATTRIBUTE_INT_RANGE:
+ case APP_DATABASE_ATTRIBUTE_FLOAT_RANGE:
+ $min ??= $attribute->getAttribute('formatOptions')['min'];
+ $max ??= $attribute->getAttribute('formatOptions')['max'];
+
+ if ($min > $max) {
+ throw new Exception($this->getInvalidValueException(), 'Minimum value must be lesser than maximum value');
+ }
+
+ if ($attribute->getAttribute('format') === APP_DATABASE_ATTRIBUTE_INT_RANGE) {
+ $validator = new Range($min, $max, Database::VAR_INTEGER);
+ } else {
+ $validator = new Range($min, $max, Database::VAR_FLOAT);
+
+ if (!is_null($default)) {
+ $default = \floatval($default);
+ }
+ }
+
+ if (!is_null($default) && !$validator->isValid($default)) {
+ throw new Exception($this->getInvalidValueException(), $validator->getDescription());
+ }
+
+ $options = [
+ 'min' => $min,
+ 'max' => $max
+ ];
+ $attribute->setAttribute('formatOptions', $options);
+
+ break;
+ case APP_DATABASE_ATTRIBUTE_ENUM:
+ if (empty($elements)) {
+ throw new Exception($this->getInvalidValueException(), 'Enum elements must not be empty');
+ }
+
+ foreach ($elements as $element) {
+ if (\strlen($element) === 0) {
+ throw new Exception($this->getInvalidValueException(), 'Each enum element must not be empty');
+ }
+ }
+
+ if (!is_null($default) && !in_array($default, $elements)) {
+ throw new Exception($this->getInvalidValueException(), 'Default value not found in elements');
+ }
+
+ $options = [
+ 'elements' => $elements
+ ];
+
+ $attribute->setAttribute('formatOptions', $options);
+
+ break;
+ }
+
+ if ($type === Database::VAR_RELATIONSHIP) {
+ $primaryDocumentOptions = \array_merge($attribute->getAttribute('options', []), $options);
+ $attribute->setAttribute('options', $primaryDocumentOptions);
+ try {
+ $dbForProject->updateRelationship(
+ collection: $collectionId,
+ id: $key,
+ newKey: $newKey,
+ onDelete: $primaryDocumentOptions['onDelete'],
+ );
+ } catch (IndexException) {
+ throw new Exception(Exception::INDEX_INVALID);
+ } catch (LimitException) {
+ throw new Exception($this->getLimitException());
+ } catch (RelationshipException $e) {
+ throw new Exception(Exception::RELATIONSHIP_VALUE_INVALID, $e->getMessage());
+ } catch (StructureException $e) {
+ throw new Exception($this->getInvalidStructureException(), $e->getMessage());
+ }
+
+ if ($primaryDocumentOptions['twoWay']) {
+ $relatedCollection = $dbForProject->getDocument('database_' . $db->getSequence(), $primaryDocumentOptions['relatedCollection']);
+
+ $relatedAttribute = $dbForProject->getDocument('attributes', $db->getSequence() . '_' . $relatedCollection->getSequence() . '_' . $primaryDocumentOptions['twoWayKey']);
+
+ if (!empty($newKey) && $newKey !== $key) {
+ $options['twoWayKey'] = $newKey;
+ }
+
+ $relatedOptions = \array_merge($relatedAttribute->getAttribute('options'), $options);
+ $relatedAttribute->setAttribute('options', $relatedOptions);
+ $dbForProject->updateDocument('attributes', $db->getSequence() . '_' . $relatedCollection->getSequence() . '_' . $primaryDocumentOptions['twoWayKey'], $relatedAttribute);
+
+ $dbForProject->purgeCachedDocument('database_' . $db->getSequence(), $relatedCollection->getId());
+ }
+ } else {
+ try {
+ $dbForProject->updateAttribute(
+ collection: $collectionId,
+ id: $key,
+ size: $size,
+ required: $required,
+ default: $default,
+ formatOptions: $options,
+ newKey: $newKey ?? null
+ );
+ } catch (DuplicateException) {
+ throw new Exception($this->getDuplicateException());
+ } catch (IndexException $e) {
+ throw new Exception($this->getInvalidIndexException(), $e->getMessage());
+ } catch (LimitException) {
+ throw new Exception($this->getLimitException());
+ } catch (TruncateException) {
+ throw new Exception($this->getInvalidResizeException());
+ }
+ }
+
+ if (!empty($newKey) && $key !== $newKey) {
+ $originalUid = $attribute->getId();
+
+ $attribute
+ ->setAttribute('$id', ID::custom($db->getSequence() . '_' . $collection->getSequence() . '_' . $newKey))
+ ->setAttribute('key', $newKey);
+
+ try {
+ $dbForProject->updateDocument('attributes', $originalUid, $attribute);
+ } catch (DuplicateException) {
+ throw new Exception($this->getDuplicateException());
+ }
+
+ /**
+ * @var Document $index
+ */
+ foreach ($collection->getAttribute('indexes') as $index) {
+ /**
+ * @var string[] $attribute
+ */
+ $attribute = $index->getAttribute('attributes', []);
+ $found = \array_search($key, $attribute);
+
+ if ($found !== false) {
+ $attribute[$found] = $newKey;
+ $index->setAttribute('attributes', $attribute);
+ $dbForProject->updateDocument('indexes', $index->getId(), $index);
+ }
+ }
+ } else {
+ $attribute = $dbForProject->updateDocument('attributes', $db->getSequence() . '_' . $collection->getSequence() . '_' . $key, $attribute);
+ }
+
+ $dbForProject->purgeCachedDocument('database_' . $db->getSequence(), $collection->getId());
+
+ $queueForEvents
+ ->setContext('database', $db)
+ ->setParam('databaseId', $databaseId)
+ ->setParam('collectionId', $collection->getId())
+ ->setParam('tableId', $collection->getId())
+ ->setParam('attributeId', $attribute->getId())
+ ->setParam('columnId', $attribute->getId())
+ ->setContext($this->getCollectionsEventsContext(), $collection);
+
+ return $attribute;
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Boolean/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Boolean/Create.php
new file mode 100644
index 0000000000..c38ef8d703
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Boolean/Create.php
@@ -0,0 +1,84 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/attributes/boolean')
+ ->desc('Create boolean attribute')
+ ->groups(['api', 'database', 'schema'])
+ ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].create')
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('audits.event', 'attribute.create')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/create-boolean-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_ACCEPTED,
+ model: $this->getResponseModel(),
+ )
+ ]
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID. You can create a new table using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
+ ->param('key', '', new Key(), 'Attribute Key.')
+ ->param('required', null, new Boolean(), 'Is attribute required?')
+ ->param('default', null, new Boolean(), 'Default value for attribute when not provided. Cannot be set when attribute is required.', true)
+ ->param('array', false, new Boolean(), 'Is attribute an array?', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $key, ?bool $required, ?bool $default, bool $array, UtopiaResponse $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents): void
+ {
+ $attribute = $this->createAttribute($databaseId, $collectionId, new Document([
+ 'key' => $key,
+ 'type' => Database::VAR_BOOLEAN,
+ 'size' => 0,
+ 'required' => $required,
+ 'default' => $default,
+ 'array' => $array,
+ ]), $response, $dbForProject, $queueForDatabase, $queueForEvents);
+
+ $response
+ ->setStatusCode(SwooleResponse::STATUS_CODE_ACCEPTED)
+ ->dynamic($attribute, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Boolean/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Boolean/Update.php
new file mode 100644
index 0000000000..9bb606edf5
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Boolean/Update.php
@@ -0,0 +1,87 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/attributes/boolean/:key')
+ ->desc('Update boolean attribute')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].update')
+ ->label('audits.event', 'attribute.update')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/update-boolean-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#createCollection).')
+ ->param('key', '', new Key(), 'Attribute Key.')
+ ->param('required', null, new Boolean(), 'Is attribute required?')
+ ->param('default', null, new Nullable(new Boolean()), 'Default value for attribute when not provided. Cannot be set when attribute is required.')
+ ->param('newKey', null, new Key(), 'New attribute key.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $key, ?bool $required, ?bool $default, ?string $newKey, UtopiaResponse $response, Database $dbForProject, Event $queueForEvents): void
+ {
+ $attribute = $this->updateAttribute(
+ databaseId: $databaseId,
+ collectionId: $collectionId,
+ key: $key,
+ dbForProject: $dbForProject,
+ queueForEvents: $queueForEvents,
+ type: Database::VAR_BOOLEAN,
+ default: $default,
+ required: $required,
+ newKey: $newKey
+ );
+
+ $response
+ ->setStatusCode(SwooleResponse::STATUS_CODE_OK)
+ ->dynamic($attribute, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Datetime/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Datetime/Create.php
new file mode 100644
index 0000000000..ff8054abe4
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Datetime/Create.php
@@ -0,0 +1,94 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/attributes/datetime')
+ ->desc('Create datetime attribute')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].create')
+ ->label('audits.event', 'attribute.create')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/create-datetime-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_ACCEPTED,
+ model: $this->getResponseModel()
+ )
+ ]
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#createCollection).')
+ ->param('key', '', new Key(), 'Attribute Key.')
+ ->param('required', null, new Boolean(), 'Is attribute required?')
+ ->param('default', null, fn (Database $dbForProject) => new DatetimeValidator($dbForProject->getAdapter()->getMinDateTime(), $dbForProject->getAdapter()->getMaxDateTime()), 'Default value for the attribute in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. Cannot be set when attribute is required.', true, ['dbForProject'])
+ ->param('array', false, new Boolean(), 'Is attribute an array?', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $key, ?bool $required, ?string $default, bool $array, UtopiaResponse $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents): void
+ {
+ $attribute = $this->createAttribute(
+ $databaseId,
+ $collectionId,
+ new Document([
+ 'key' => $key,
+ 'type' => Database::VAR_DATETIME,
+ 'size' => 0,
+ 'required' => $required,
+ 'default' => $default,
+ 'array' => $array,
+ 'filters' => ['datetime'],
+ ]),
+ $response,
+ $dbForProject,
+ $queueForDatabase,
+ $queueForEvents
+ );
+
+ $response
+ ->setStatusCode(SwooleResponse::STATUS_CODE_ACCEPTED)
+ ->dynamic($attribute, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Datetime/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Datetime/Update.php
new file mode 100644
index 0000000000..5f8909a294
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Datetime/Update.php
@@ -0,0 +1,88 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/attributes/datetime/:key')
+ ->desc('Update datetime attribute')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].update')
+ ->label('audits.event', 'attribute.update')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/update-datetime-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel()
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('key', '', new Key(), 'Attribute Key.')
+ ->param('required', null, new Boolean(), 'Is attribute required?')
+ ->param('default', null, fn (Database $dbForProject) => new Nullable(new DatetimeValidator($dbForProject->getAdapter()->getMinDateTime(), $dbForProject->getAdapter()->getMaxDateTime())), 'Default value for attribute when not provided. Cannot be set when attribute is required.', injections: ['dbForProject'])
+ ->param('newKey', null, new Key(), 'New attribute key.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $key, ?bool $required, ?string $default, ?string $newKey, UtopiaResponse $response, Database $dbForProject, Event $queueForEvents): void
+ {
+ $attribute = $this->updateAttribute(
+ databaseId: $databaseId,
+ collectionId: $collectionId,
+ key: $key,
+ dbForProject: $dbForProject,
+ queueForEvents: $queueForEvents,
+ type: Database::VAR_DATETIME,
+ default: $default,
+ required: $required,
+ newKey: $newKey
+ );
+
+ $response
+ ->setStatusCode(SwooleResponse::STATUS_CODE_OK)
+ ->dynamic($attribute, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Delete.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Delete.php
new file mode 100644
index 0000000000..5816de31a2
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Delete.php
@@ -0,0 +1,154 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_DELETE)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/attributes/:key')
+ ->desc('Delete attribute')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].update')
+ ->label('audits.event', 'attribute.delete')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/delete-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_NOCONTENT,
+ model: UtopiaResponse::MODEL_NONE,
+ )
+ ],
+ contentType: ContentType::NONE
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('key', '', new Key(), 'Attribute Key.')
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $key, UtopiaResponse $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents): void
+ {
+ $db = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
+ if ($db->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $collection = $dbForProject->getDocument('database_' . $db->getSequence(), $collectionId);
+ if ($collection->isEmpty()) {
+ throw new Exception($this->getParentNotFoundException());
+ }
+
+ $attribute = $dbForProject->getDocument('attributes', $db->getSequence() . '_' . $collection->getSequence() . '_' . $key);
+ if ($attribute->isEmpty()) {
+ throw new Exception($this->getNotFoundException());
+ }
+
+ $validator = new IndexDependencyValidator(
+ $collection->getAttribute('indexes'),
+ $dbForProject->getAdapter()->getSupportForCastIndexArray(),
+ );
+
+ if (!$validator->isValid($attribute)) {
+ throw new Exception($this->getIndexDependencyException());
+ }
+
+ if ($attribute->getAttribute('status') === 'available') {
+ $attribute = $dbForProject->updateDocument('attributes', $attribute->getId(), $attribute->setAttribute('status', 'deleting'));
+ }
+
+ $dbForProject->purgeCachedDocument('database_' . $db->getSequence(), $collectionId);
+ $dbForProject->purgeCachedCollection('database_' . $db->getSequence() . '_collection_' . $collection->getSequence());
+
+ if ($attribute->getAttribute('type') === Database::VAR_RELATIONSHIP) {
+ $options = $attribute->getAttribute('options');
+ if ($options['twoWay']) {
+ $relatedCollection = $dbForProject->getDocument('database_' . $db->getSequence(), $options['relatedCollection']);
+ if ($relatedCollection->isEmpty()) {
+ throw new Exception($this->getParentNotFoundException());
+ }
+
+ $relatedAttribute = $dbForProject->getDocument('attributes', $db->getSequence() . '_' . $relatedCollection->getSequence() . '_' . $options['twoWayKey']);
+ if ($relatedAttribute->isEmpty()) {
+ throw new Exception($this->getNotFoundException());
+ }
+
+ if ($relatedAttribute->getAttribute('status') === 'available') {
+ $dbForProject->updateDocument('attributes', $relatedAttribute->getId(), $relatedAttribute->setAttribute('status', 'deleting'));
+ }
+
+ $dbForProject->purgeCachedDocument('database_' . $db->getSequence(), $options['relatedCollection']);
+ $dbForProject->purgeCachedCollection('database_' . $db->getSequence() . '_collection_' . $relatedCollection->getSequence());
+ }
+ }
+
+ $queueForDatabase
+ ->setDatabase($db)
+ ->setType(DATABASE_TYPE_DELETE_ATTRIBUTE);
+
+ if ($this->isCollectionsAPI()) {
+ $queueForDatabase
+ ->setRow($attribute)
+ ->setTable($collection);
+ } else {
+ $queueForDatabase
+ ->setDocument($attribute)
+ ->setCollection($collection);
+ }
+
+ $type = $attribute->getAttribute('type');
+ $format = $attribute->getAttribute('format');
+
+ $model = $this->getModel($type, $format);
+
+ $queueForEvents
+ ->setContext('database', $db)
+ ->setParam('databaseId', $databaseId)
+ ->setParam('collectionId', $collection->getId())
+ ->setParam('tableId', $collection->getId())
+ ->setParam('attributeId', $attribute->getId())
+ ->setParam('columnId', $attribute->getId())
+ ->setPayload($response->output($attribute, $model))
+ ->setContext($this->getCollectionsEventsContext(), $collection);
+
+ $response->noContent();
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Email/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Email/Create.php
new file mode 100644
index 0000000000..3c703f23a7
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Email/Create.php
@@ -0,0 +1,94 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/attributes/email')
+ ->desc('Create email attribute')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].create')
+ ->label('audits.event', 'attribute.create')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/create-email-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_ACCEPTED,
+ model: $this->getResponseModel(),
+ )
+ ]
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('key', '', new Key(), 'Attribute Key.')
+ ->param('required', null, new Boolean(), 'Is attribute required?')
+ ->param('default', null, new Email(), 'Default value for attribute when not provided. Cannot be set when attribute is required.', true)
+ ->param('array', false, new Boolean(), 'Is attribute an array?', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $key, ?bool $required, ?string $default, bool $array, UtopiaResponse $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents): void
+ {
+ $attribute = $this->createAttribute(
+ $databaseId,
+ $collectionId,
+ new Document([
+ 'key' => $key,
+ 'type' => Database::VAR_STRING,
+ 'size' => 254,
+ 'required' => $required,
+ 'default' => $default,
+ 'array' => $array,
+ 'format' => APP_DATABASE_ATTRIBUTE_EMAIL,
+ ]),
+ $response,
+ $dbForProject,
+ $queueForDatabase,
+ $queueForEvents
+ );
+
+ $response
+ ->setStatusCode(SwooleResponse::STATUS_CODE_ACCEPTED)
+ ->dynamic($attribute, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Email/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Email/Update.php
new file mode 100644
index 0000000000..c8a34cf55c
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Email/Update.php
@@ -0,0 +1,89 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/attributes/email/:key')
+ ->desc('Update email attribute')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].update')
+ ->label('audits.event', 'attribute.update')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/update-email-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('key', '', new Key(), 'Attribute Key.')
+ ->param('required', null, new Boolean(), 'Is attribute required?')
+ ->param('default', null, new Nullable(new Email()), 'Default value for attribute when not provided. Cannot be set when attribute is required.')
+ ->param('newKey', null, new Key(), 'New Attribute Key.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $key, ?bool $required, ?string $default, ?string $newKey, UtopiaResponse $response, Database $dbForProject, Event $queueForEvents): void
+ {
+ $attribute = $this->updateAttribute(
+ databaseId: $databaseId,
+ collectionId: $collectionId,
+ key: $key,
+ dbForProject: $dbForProject,
+ queueForEvents: $queueForEvents,
+ type: Database::VAR_STRING,
+ filter: APP_DATABASE_ATTRIBUTE_EMAIL,
+ default: $default,
+ required: $required,
+ newKey: $newKey
+ );
+
+ $response
+ ->setStatusCode(SwooleResponse::STATUS_CODE_OK)
+ ->dynamic($attribute, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Enum/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Enum/Create.php
new file mode 100644
index 0000000000..99d540a4c2
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Enum/Create.php
@@ -0,0 +1,102 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/attributes/enum')
+ ->desc('Create enum attribute')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].create')
+ ->label('audits.event', 'attribute.create')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/create-attribute-enum.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_ACCEPTED,
+ model: $this->getResponseModel(),
+ )
+ ]
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('key', '', new Key(), 'Attribute Key.')
+ ->param('elements', [], new ArrayList(new Text(Database::LENGTH_KEY), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Array of enum values.')
+ ->param('required', null, new Boolean(), 'Is attribute required?')
+ ->param('default', null, new Text(0), 'Default value for attribute when not provided. Cannot be set when attribute is required.', true)
+ ->param('array', false, new Boolean(), 'Is attribute an array?', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $key, array $elements, ?bool $required, ?string $default, bool $array, UtopiaResponse $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents): void
+ {
+ if (!is_null($default) && !\in_array($default, $elements, true)) {
+ throw new Exception($this->getInvalidValueException(), 'Default value not found in elements');
+ }
+
+ $attribute = $this->createAttribute(
+ $databaseId,
+ $collectionId,
+ new Document([
+ 'key' => $key,
+ 'type' => Database::VAR_STRING,
+ 'size' => Database::LENGTH_KEY,
+ 'required' => $required,
+ 'default' => $default,
+ 'array' => $array,
+ 'format' => APP_DATABASE_ATTRIBUTE_ENUM,
+ 'formatOptions' => ['elements' => $elements],
+ ]),
+ $response,
+ $dbForProject,
+ $queueForDatabase,
+ $queueForEvents
+ );
+
+ $response
+ ->setStatusCode(SwooleResponse::STATUS_CODE_ACCEPTED)
+ ->dynamic($attribute, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Enum/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Enum/Update.php
new file mode 100644
index 0000000000..8624bde78d
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Enum/Update.php
@@ -0,0 +1,92 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/attributes/enum/:key')
+ ->desc('Update enum attribute')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].update')
+ ->label('audits.event', 'attribute.update')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/update-enum-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('key', '', new Key(), 'Attribute Key.')
+ ->param('elements', null, new ArrayList(new Text(Database::LENGTH_KEY), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Updated list of enum values.')
+ ->param('required', null, new Boolean(), 'Is attribute required?')
+ ->param('default', null, new Nullable(new Text(0)), 'Default value for attribute when not provided. Cannot be set when attribute is required.')
+ ->param('newKey', null, new Key(), 'New Attribute Key.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $key, ?array $elements, ?bool $required, ?string $default, ?string $newKey, UtopiaResponse $response, Database $dbForProject, Event $queueForEvents): void
+ {
+ $attribute = $this->updateAttribute(
+ databaseId: $databaseId,
+ collectionId: $collectionId,
+ key: $key,
+ dbForProject: $dbForProject,
+ queueForEvents: $queueForEvents,
+ type: Database::VAR_STRING,
+ filter: APP_DATABASE_ATTRIBUTE_ENUM,
+ default: $default,
+ required: $required,
+ elements: $elements,
+ newKey: $newKey
+ );
+
+ $response
+ ->setStatusCode(SwooleResponse::STATUS_CODE_OK)
+ ->dynamic($attribute, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Float/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Float/Create.php
new file mode 100644
index 0000000000..520366f689
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Float/Create.php
@@ -0,0 +1,109 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/attributes/float')
+ ->desc('Create float attribute')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].create')
+ ->label('audits.event', 'attribute.create')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/create-float-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_ACCEPTED,
+ model: $this->getResponseModel(),
+ )
+ ]
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('key', '', new Key(), 'Attribute Key.')
+ ->param('required', null, new Boolean(), 'Is attribute required?')
+ ->param('min', null, new FloatValidator(), 'Minimum value.', true)
+ ->param('max', null, new FloatValidator(), 'Maximum value.', true)
+ ->param('default', null, new FloatValidator(), 'Default value. Cannot be set when required.', true)
+ ->param('array', false, new Boolean(), 'Is attribute an array?', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $key, ?bool $required, ?float $min, ?float $max, ?float $default, bool $array, UtopiaResponse $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents): void
+ {
+ $min ??= -PHP_FLOAT_MAX;
+ $max ??= PHP_FLOAT_MAX;
+
+ if ($min > $max) {
+ throw new Exception($this->getInvalidValueException(), 'Minimum value must be lesser than maximum value');
+ }
+
+ $validator = new Range($min, $max, Database::VAR_FLOAT);
+ if (!\is_null($default) && !$validator->isValid($default)) {
+ throw new Exception($this->getInvalidValueException(), $validator->getDescription());
+ }
+
+ $attribute = $this->createAttribute($databaseId, $collectionId, new Document([
+ 'key' => $key,
+ 'type' => Database::VAR_FLOAT,
+ 'size' => 0,
+ 'required' => $required,
+ 'default' => $default,
+ 'array' => $array,
+ 'format' => APP_DATABASE_ATTRIBUTE_FLOAT_RANGE,
+ 'formatOptions' => ['min' => $min, 'max' => $max],
+ ]), $response, $dbForProject, $queueForDatabase, $queueForEvents);
+
+ $formatOptions = $attribute->getAttribute('formatOptions', []);
+ if (!empty($formatOptions)) {
+ $attribute->setAttribute('min', \floatval($formatOptions['min']));
+ $attribute->setAttribute('max', \floatval($formatOptions['max']));
+ }
+
+ $response
+ ->setStatusCode(SwooleResponse::STATUS_CODE_ACCEPTED)
+ ->dynamic($attribute, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Float/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Float/Update.php
new file mode 100644
index 0000000000..18a966d91d
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Float/Update.php
@@ -0,0 +1,98 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/attributes/float/:key')
+ ->desc('Update float attribute')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].update')
+ ->label('audits.event', 'attribute.update')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/update-float-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('key', '', new Key(), 'Attribute Key.')
+ ->param('required', null, new Boolean(), 'Is attribute required?')
+ ->param('min', null, new FloatValidator(), 'Minimum value.', true)
+ ->param('max', null, new FloatValidator(), 'Maximum value.', true)
+ ->param('default', null, new Nullable(new FloatValidator()), 'Default value. Cannot be set when required.')
+ ->param('newKey', null, new Key(), 'New Attribute Key.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $key, ?bool $required, ?float $min, ?float $max, ?float $default, ?string $newKey, UtopiaResponse $response, Database $dbForProject, Event $queueForEvents): void
+ {
+ $attribute = $this->updateAttribute(
+ databaseId: $databaseId,
+ collectionId: $collectionId,
+ key: $key,
+ dbForProject: $dbForProject,
+ queueForEvents: $queueForEvents,
+ type: Database::VAR_FLOAT,
+ default: $default,
+ required: $required,
+ min: $min,
+ max: $max,
+ newKey: $newKey
+ );
+
+ $formatOptions = $attribute->getAttribute('formatOptions', []);
+ if (!empty($formatOptions)) {
+ $attribute->setAttribute('min', \floatval($formatOptions['min']));
+ $attribute->setAttribute('max', \floatval($formatOptions['max']));
+ }
+
+ $response
+ ->setStatusCode(SwooleResponse::STATUS_CODE_OK)
+ ->dynamic($attribute, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Get.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Get.php
new file mode 100644
index 0000000000..579f7883e0
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Get.php
@@ -0,0 +1,100 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/attributes/:key')
+ ->desc('Get attribute')
+ ->groups(['api', 'database'])
+ ->label('scope', 'collections.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/get-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel()
+ )
+ ]
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('key', '', new Key(), 'Attribute Key.')
+ ->inject('response')
+ ->inject('dbForProject')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $key, UtopiaResponse $response, Database $dbForProject): void
+ {
+ $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
+ if ($database->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
+ if ($collection->isEmpty()) {
+ throw new Exception($this->getParentNotFoundException());
+ }
+
+ $attribute = $dbForProject->getDocument('attributes', $database->getSequence() . '_' . $collection->getSequence() . '_' . $key);
+ if ($attribute->isEmpty()) {
+ throw new Exception($this->getNotFoundException());
+ }
+
+ $type = $attribute->getAttribute('type');
+ $format = $attribute->getAttribute('format');
+ $options = $attribute->getAttribute('options', []);
+ $filters = $attribute->getAttribute('filters', []);
+ foreach ($options as $key => $option) {
+ $attribute->setAttribute($key, $option);
+ }
+
+ $model = $this->getModel($type, $format);
+
+ $attribute->setAttribute('encrypt', in_array('encrypt', $filters));
+
+ $response->dynamic($attribute, $model);
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/IP/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/IP/Create.php
new file mode 100644
index 0000000000..e46e508bc6
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/IP/Create.php
@@ -0,0 +1,94 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/attributes/ip')
+ ->desc('Create IP address attribute')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].create')
+ ->label('audits.event', 'attribute.create')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/create-ip-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_ACCEPTED,
+ model: $this->getResponseModel(),
+ )
+ ]
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('key', '', new Key(), 'Attribute Key.')
+ ->param('required', null, new Boolean(), 'Is attribute required?')
+ ->param('default', null, new IP(), 'Default value. Cannot be set when attribute is required.', true)
+ ->param('array', false, new Boolean(), 'Is attribute an array?', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $key, ?bool $required, ?string $default, bool $array, UtopiaResponse $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents): void
+ {
+ $attribute = $this->createAttribute(
+ $databaseId,
+ $collectionId,
+ new Document([
+ 'key' => $key,
+ 'type' => Database::VAR_STRING,
+ 'size' => 39,
+ 'required' => $required,
+ 'default' => $default,
+ 'array' => $array,
+ 'format' => APP_DATABASE_ATTRIBUTE_IP,
+ ]),
+ $response,
+ $dbForProject,
+ $queueForDatabase,
+ $queueForEvents
+ );
+
+ $response
+ ->setStatusCode(SwooleResponse::STATUS_CODE_ACCEPTED)
+ ->dynamic($attribute, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/IP/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/IP/Update.php
new file mode 100644
index 0000000000..e9d9404c17
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/IP/Update.php
@@ -0,0 +1,89 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/attributes/ip/:key')
+ ->desc('Update IP address attribute')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].update')
+ ->label('audits.event', 'attribute.update')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/update-ip-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('key', '', new Key(), 'Attribute Key.')
+ ->param('required', null, new Boolean(), 'Is attribute required?')
+ ->param('default', null, new Nullable(new IP()), 'Default value. Cannot be set when attribute is required.')
+ ->param('newKey', null, new Key(), 'New Attribute Key.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $key, ?bool $required, ?string $default, ?string $newKey, UtopiaResponse $response, Database $dbForProject, Event $queueForEvents): void
+ {
+ $attribute = $this->updateAttribute(
+ databaseId: $databaseId,
+ collectionId: $collectionId,
+ key: $key,
+ dbForProject: $dbForProject,
+ queueForEvents: $queueForEvents,
+ type: Database::VAR_STRING,
+ filter: APP_DATABASE_ATTRIBUTE_IP,
+ default: $default,
+ required: $required,
+ newKey: $newKey
+ );
+
+ $response
+ ->setStatusCode(SwooleResponse::STATUS_CODE_OK)
+ ->dynamic($attribute, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Integer/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Integer/Create.php
new file mode 100644
index 0000000000..e348e9a2a6
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Integer/Create.php
@@ -0,0 +1,111 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/attributes/integer')
+ ->desc('Create integer attribute')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].create')
+ ->label('audits.event', 'attribute.create')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/create-integer-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_ACCEPTED,
+ model: $this->getResponseModel(),
+ )
+ ]
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('key', '', new Key(), 'Attribute Key.')
+ ->param('required', null, new Boolean(), 'Is attribute required?')
+ ->param('min', null, new Integer(), 'Minimum value', true)
+ ->param('max', null, new Integer(), 'Maximum value', true)
+ ->param('default', null, new Integer(), 'Default value. Cannot be set when attribute is required.', true)
+ ->param('array', false, new Boolean(), 'Is attribute an array?', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $key, ?bool $required, ?int $min, ?int $max, ?int $default, bool $array, UtopiaResponse $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents): void
+ {
+ $min ??= \PHP_INT_MIN;
+ $max ??= \PHP_INT_MAX;
+
+ if ($min > $max) {
+ throw new Exception($this->getInvalidValueException(), 'Minimum value must be lesser than maximum value');
+ }
+
+ $validator = new Range($min, $max, Database::VAR_INTEGER);
+ if (!\is_null($default) && !$validator->isValid($default)) {
+ throw new Exception($this->getInvalidValueException(), $validator->getDescription());
+ }
+
+ $size = $max > 2147483647 ? 8 : 4;
+
+ $attribute = $this->createAttribute($databaseId, $collectionId, new Document([
+ 'key' => $key,
+ 'type' => Database::VAR_INTEGER,
+ 'size' => $size,
+ 'required' => $required,
+ 'default' => $default,
+ 'array' => $array,
+ 'format' => APP_DATABASE_ATTRIBUTE_INT_RANGE,
+ 'formatOptions' => ['min' => $min, 'max' => $max],
+ ]), $response, $dbForProject, $queueForDatabase, $queueForEvents);
+
+ $formatOptions = $attribute->getAttribute('formatOptions', []);
+ if (!empty($formatOptions)) {
+ $attribute->setAttribute('min', \intval($formatOptions['min']));
+ $attribute->setAttribute('max', \intval($formatOptions['max']));
+ }
+
+ $response
+ ->setStatusCode(SwooleResponse::STATUS_CODE_ACCEPTED)
+ ->dynamic($attribute, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Integer/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Integer/Update.php
new file mode 100644
index 0000000000..bbbf045115
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Integer/Update.php
@@ -0,0 +1,98 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/attributes/integer/:key')
+ ->desc('Update integer attribute')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].update')
+ ->label('audits.event', 'attribute.update')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/update-integer-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('key', '', new Key(), 'Attribute Key.')
+ ->param('required', null, new Boolean(), 'Is attribute required?')
+ ->param('min', null, new Integer(), 'Minimum value', true)
+ ->param('max', null, new Integer(), 'Maximum value', true)
+ ->param('default', null, new Nullable(new Integer()), 'Default value. Cannot be set when attribute is required.')
+ ->param('newKey', null, new Key(), 'New Attribute Key.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $key, ?bool $required, ?int $min, ?int $max, ?int $default, ?string $newKey, UtopiaResponse $response, Database $dbForProject, Event $queueForEvents): void
+ {
+ $attribute = $this->updateAttribute(
+ databaseId: $databaseId,
+ collectionId: $collectionId,
+ key: $key,
+ dbForProject: $dbForProject,
+ queueForEvents: $queueForEvents,
+ type: Database::VAR_INTEGER,
+ default: $default,
+ required: $required,
+ min: $min,
+ max: $max,
+ newKey: $newKey
+ );
+
+ $formatOptions = $attribute->getAttribute('formatOptions', []);
+ if (!empty($formatOptions)) {
+ $attribute->setAttribute('min', \intval($formatOptions['min']));
+ $attribute->setAttribute('max', \intval($formatOptions['max']));
+ }
+
+ $response
+ ->setStatusCode(SwooleResponse::STATUS_CODE_OK)
+ ->dynamic($attribute, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Relationship/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Relationship/Create.php
new file mode 100644
index 0000000000..795ea445c8
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Relationship/Create.php
@@ -0,0 +1,157 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/attributes/relationship')
+ ->desc('Create relationship attribute')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].create')
+ ->label('audits.event', 'attribute.create')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/create-relationship-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_ACCEPTED,
+ model: $this->getResponseModel()
+ )
+ ]
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('relatedCollectionId', '', new UID(), 'Related Collection ID.')
+ ->param('type', '', new WhiteList([
+ Database::RELATION_ONE_TO_ONE,
+ Database::RELATION_MANY_TO_ONE,
+ Database::RELATION_MANY_TO_MANY,
+ Database::RELATION_ONE_TO_MANY
+ ], true), 'Relation type')
+ ->param('twoWay', false, new Boolean(), 'Is Two Way?', true)
+ ->param('key', null, new Key(), 'Attribute Key.', true)
+ ->param('twoWayKey', null, new Key(), 'Two Way Attribute Key.', true)
+ ->param('onDelete', Database::RELATION_MUTATE_RESTRICT, new WhiteList([
+ Database::RELATION_MUTATE_CASCADE,
+ Database::RELATION_MUTATE_RESTRICT,
+ Database::RELATION_MUTATE_SET_NULL
+ ], true), 'Constraints option', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $relatedCollectionId, string $type, bool $twoWay, ?string $key, ?string $twoWayKey, string $onDelete, UtopiaResponse $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents): void
+ {
+ $key ??= $relatedCollectionId;
+ $twoWayKey ??= $collectionId;
+
+ $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
+ if ($database->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
+ $collection = $dbForProject->getCollection('database_' . $database->getSequence() . '_collection_' . $collection->getSequence());
+ if ($collection->isEmpty()) {
+ throw new Exception($this->getParentNotFoundException());
+ }
+
+ $relatedCollectionDocument = $dbForProject->getDocument('database_' . $database->getSequence(), $relatedCollectionId);
+ $relatedCollection = $dbForProject->getCollection('database_' . $database->getSequence() . '_collection_' . $relatedCollectionDocument->getSequence());
+ if ($relatedCollection->isEmpty()) {
+ throw new Exception($this->getParentNotFoundException());
+ }
+
+ $attributes = $collection->getAttribute('attributes', []);
+ foreach ($attributes as $attribute) {
+ if ($attribute->getAttribute('type') !== Database::VAR_RELATIONSHIP) {
+ continue;
+ }
+
+ if (\strtolower($attribute->getId()) === \strtolower($key)) {
+ throw new Exception($this->getDuplicateException());
+ }
+
+ if (
+ \strtolower($attribute->getAttribute('options')['twoWayKey']) === \strtolower($twoWayKey) &&
+ $attribute->getAttribute('options')['relatedCollection'] === $relatedCollection->getId()
+ ) {
+ throw new Exception($this->getDuplicateException(), 'Attribute with the requested key already exists. Attribute keys must be unique, try again with a different key.');
+ }
+
+ if (
+ $type === Database::RELATION_MANY_TO_MANY &&
+ $attribute->getAttribute('options')['relationType'] === Database::RELATION_MANY_TO_MANY &&
+ $attribute->getAttribute('options')['relatedCollection'] === $relatedCollection->getId()
+ ) {
+ $parentType = $this->isCollectionsAPI() ? 'collection' : 'table';
+ throw new Exception($this->getDuplicateException(), "Creating more than one \"manyToMany\" relationship on the same $parentType is currently not permitted.");
+ }
+ }
+
+ $attribute = $this->createAttribute($databaseId, $collectionId, new Document([
+ 'key' => $key,
+ 'type' => Database::VAR_RELATIONSHIP,
+ 'size' => 0,
+ 'required' => false,
+ 'default' => null,
+ 'array' => false,
+ 'filters' => [],
+ 'options' => [
+ 'relatedCollection' => $relatedCollectionId,
+ 'relationType' => $type,
+ 'twoWay' => $twoWay,
+ 'twoWayKey' => $twoWayKey,
+ 'onDelete' => $onDelete,
+ ]
+ ]), $response, $dbForProject, $queueForDatabase, $queueForEvents);
+
+ foreach ($attribute->getAttribute('options', []) as $k => $option) {
+ $attribute->setAttribute($k, $option);
+ }
+
+ $response
+ ->setStatusCode(SwooleResponse::STATUS_CODE_ACCEPTED)
+ ->dynamic($attribute, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Relationship/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Relationship/Update.php
new file mode 100644
index 0000000000..7202a3e4e6
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/Relationship/Update.php
@@ -0,0 +1,103 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/attributes/:key/relationship')
+ ->desc('Update relationship attribute')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].update')
+ ->label('audits.event', 'attribute.update')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/update-relationship-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel()
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('key', '', new Key(), 'Attribute Key.')
+ ->param('onDelete', null, new WhiteList([
+ Database::RELATION_MUTATE_CASCADE,
+ Database::RELATION_MUTATE_RESTRICT,
+ Database::RELATION_MUTATE_SET_NULL
+ ], true), 'Constraints option', true)
+ ->param('newKey', null, new Key(), 'New Attribute Key.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(
+ string $databaseId,
+ string $collectionId,
+ string $key,
+ ?string $onDelete,
+ ?string $newKey,
+ UtopiaResponse $response,
+ Database $dbForProject,
+ Event $queueForEvents
+ ): void {
+ $attribute = $this->updateAttribute(
+ databaseId: $databaseId,
+ collectionId: $collectionId,
+ key: $key,
+ dbForProject: $dbForProject,
+ queueForEvents: $queueForEvents,
+ type: Database::VAR_RELATIONSHIP,
+ required: false,
+ options: [
+ 'onDelete' => $onDelete
+ ],
+ newKey: $newKey
+ );
+
+ foreach ($attribute->getAttribute('options', []) as $k => $option) {
+ $attribute->setAttribute($k, $option);
+ }
+
+ $response
+ ->setStatusCode(SwooleResponse::STATUS_CODE_OK)
+ ->dynamic($attribute, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/String/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/String/Create.php
new file mode 100644
index 0000000000..8ce8626f3a
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/String/Create.php
@@ -0,0 +1,137 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/attributes/string')
+ ->desc('Create string attribute')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].create')
+ ->label('audits.event', 'attribute.create')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/create-string-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_ACCEPTED,
+ model: $this->getResponseModel()
+ )
+ ]
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID. You can create a new table using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
+ ->param('key', '', new Key(), 'Attribute Key.')
+ ->param('size', null, new Range(1, APP_DATABASE_ATTRIBUTE_STRING_MAX_LENGTH, Validator::TYPE_INTEGER), 'Attribute size for text attributes, in number of characters.')
+ ->param('required', null, new Boolean(), 'Is attribute required?')
+ ->param('default', null, new Text(0, 0), 'Default value for attribute when not provided. Cannot be set when attribute is required.', true)
+ ->param('array', false, new Boolean(), 'Is attribute an array?', true)
+ ->param('encrypt', false, new Boolean(), 'Toggle encryption for the attribute. Encryption enhances security by not storing any plain text values in the database. However, encrypted attributes cannot be queried.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->inject('plan')
+ ->callback($this->action(...));
+ }
+
+ public function action(
+ string $databaseId,
+ string $collectionId,
+ string $key,
+ ?int $size,
+ ?bool $required,
+ ?string $default,
+ bool $array,
+ bool $encrypt,
+ UtopiaResponse $response,
+ Database $dbForProject,
+ EventDatabase $queueForDatabase,
+ Event $queueForEvents,
+ array $plan
+ ): void {
+ if ($encrypt && !empty($plan) && !($plan['databasesAllowEncrypt'] ?? false)) {
+ throw new Exception(Exception::GENERAL_BAD_REQUEST, 'Encrypted string ' . $this->getSdkGroup() . ' are not available on your plan. Please upgrade to create encrypted string ' . $this->getSdkGroup() . '.');
+ }
+
+ if ($encrypt && $size < APP_DATABASE_ENCRYPT_SIZE_MIN) {
+ throw new Exception(
+ Exception::GENERAL_BAD_REQUEST,
+ "Size too small. Encrypted strings require a minimum size of " . APP_DATABASE_ENCRYPT_SIZE_MIN . " characters."
+ );
+ }
+
+ // Ensure default fits in the given size
+ $validator = new Text($size, 0);
+ if (!is_null($default) && !$validator->isValid($default)) {
+ throw new Exception($this->getInvalidValueException(), $validator->getDescription());
+ }
+
+ $filters = [];
+ if ($encrypt) {
+ $filters[] = 'encrypt';
+ }
+
+ $attribute = $this->createAttribute(
+ $databaseId,
+ $collectionId,
+ new Document([
+ 'key' => $key,
+ 'type' => Database::VAR_STRING,
+ 'size' => $size,
+ 'required' => $required,
+ 'default' => $default,
+ 'array' => $array,
+ 'filters' => $filters,
+ ]),
+ $response,
+ $dbForProject,
+ $queueForDatabase,
+ $queueForEvents
+ );
+
+ $attribute->setAttribute('encrypt', $encrypt);
+
+ $response
+ ->setStatusCode(SwooleResponse::STATUS_CODE_ACCEPTED)
+ ->dynamic($attribute, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/String/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/String/Update.php
new file mode 100644
index 0000000000..b359b83eaa
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/String/Update.php
@@ -0,0 +1,102 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/attributes/string/:key')
+ ->desc('Update string attribute')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].update')
+ ->label('audits.event', 'attribute.update')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/update-string-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID. You can create a new table using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
+ ->param('key', '', new Key(), 'Attribute Key.')
+ ->param('required', null, new Boolean(), 'Is attribute required?')
+ ->param('default', null, new Nullable(new Text(0, 0)), 'Default value for attribute when not provided. Cannot be set when attribute is required.')
+ ->param('size', null, new Range(1, APP_DATABASE_ATTRIBUTE_STRING_MAX_LENGTH, Validator::TYPE_INTEGER), 'Maximum size of the string attribute.', true)
+ ->param('newKey', null, new Key(), 'New Attribute Key.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(
+ string $databaseId,
+ string $collectionId,
+ string $key,
+ ?bool $required,
+ ?string $default,
+ ?int $size,
+ ?string $newKey,
+ UtopiaResponse $response,
+ Database $dbForProject,
+ Event $queueForEvents
+ ): void {
+ $attribute = $this->updateAttribute(
+ databaseId: $databaseId,
+ collectionId: $collectionId,
+ key: $key,
+ dbForProject: $dbForProject,
+ queueForEvents: $queueForEvents,
+ type: Database::VAR_STRING,
+ size: $size,
+ default: $default,
+ required: $required,
+ newKey: $newKey
+ );
+
+ $response
+ ->setStatusCode(SwooleResponse::STATUS_CODE_OK)
+ ->dynamic($attribute, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/URL/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/URL/Create.php
new file mode 100644
index 0000000000..27bc2d38c1
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/URL/Create.php
@@ -0,0 +1,96 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/attributes/url')
+ ->desc('Create URL attribute')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].create')
+ ->label('audits.event', 'attribute.create')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/create-url-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_ACCEPTED,
+ model: $this->getResponseModel(),
+ )
+ ]
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('key', '', new Key(), 'Attribute Key.')
+ ->param('required', null, new Boolean(), 'Is attribute required?')
+ ->param('default', null, new URL(), 'Default value for attribute when not provided. Cannot be set when attribute is required.', true)
+ ->param('array', false, new Boolean(), 'Is attribute an array?', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(
+ string $databaseId,
+ string $collectionId,
+ string $key,
+ ?bool $required,
+ ?string $default,
+ bool $array,
+ UtopiaResponse $response,
+ Database $dbForProject,
+ EventDatabase $queueForDatabase,
+ Event $queueForEvents
+ ): void {
+ $attribute = $this->createAttribute($databaseId, $collectionId, new Document([
+ 'key' => $key,
+ 'type' => Database::VAR_STRING,
+ 'size' => 2000,
+ 'required' => $required,
+ 'default' => $default,
+ 'array' => $array,
+ 'format' => APP_DATABASE_ATTRIBUTE_URL,
+ ]), $response, $dbForProject, $queueForDatabase, $queueForEvents);
+
+ $response
+ ->setStatusCode(SwooleResponse::STATUS_CODE_ACCEPTED)
+ ->dynamic($attribute, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/URL/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/URL/Update.php
new file mode 100644
index 0000000000..ae48c43653
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/URL/Update.php
@@ -0,0 +1,98 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/attributes/url/:key')
+ ->desc('Update URL attribute')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].collections.[collectionId].attributes.[attributeId].update')
+ ->label('audits.event', 'attribute.update')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/update-url-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('key', '', new Key(), 'Attribute Key.')
+ ->param('required', null, new Boolean(), 'Is attribute required?')
+ ->param('default', null, new Nullable(new URL()), 'Default value for attribute when not provided. Cannot be set when attribute is required.')
+ ->param('newKey', null, new Key(), 'New Attribute Key.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(
+ string $databaseId,
+ string $collectionId,
+ string $key,
+ ?bool $required,
+ ?string $default,
+ ?string $newKey,
+ UtopiaResponse $response,
+ Database $dbForProject,
+ Event $queueForEvents
+ ): void {
+ $attribute = $this->updateAttribute(
+ $databaseId,
+ $collectionId,
+ $key,
+ $dbForProject,
+ $queueForEvents,
+ type: Database::VAR_STRING,
+ filter: APP_DATABASE_ATTRIBUTE_URL,
+ default: $default,
+ required: $required,
+ newKey: $newKey
+ );
+
+ $response
+ ->setStatusCode(SwooleResponse::STATUS_CODE_OK)
+ ->dynamic($attribute, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/XList.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/XList.php
new file mode 100644
index 0000000000..e09420d7ce
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Attributes/XList.php
@@ -0,0 +1,142 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/attributes')
+ ->desc('List attributes')
+ ->groups(['api', 'database'])
+ ->label('scope', 'collections.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/list-attributes.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel()
+ )
+ ]
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('queries', [], new Attributes(), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long. You may filter on the following attributes: ' . implode(', ', Attributes::ALLOWED_ATTRIBUTES), true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, array $queries, UtopiaResponse $response, Database $dbForProject): void
+ {
+ $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
+ if ($database->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
+ if ($collection->isEmpty()) {
+ throw new Exception($this->getParentNotFoundException());
+ }
+
+ try {
+ $queries = Query::parseQueries($queries);
+ } catch (QueryException $e) {
+ throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
+ }
+
+ \array_push(
+ $queries,
+ Query::equal('databaseInternalId', [$database->getSequence()]),
+ Query::equal('collectionInternalId', [$collection->getSequence()])
+ );
+
+ $cursor = \array_filter(
+ $queries,
+ fn ($query) => \in_array($query->getMethod(), [Query::TYPE_CURSOR_AFTER, Query::TYPE_CURSOR_BEFORE])
+ );
+ $cursor = \reset($cursor);
+
+ if ($cursor) {
+ $validator = new Cursor();
+ if (!$validator->isValid($cursor)) {
+ throw new Exception(Exception::GENERAL_QUERY_INVALID, $validator->getDescription());
+ }
+
+ $attributeId = $cursor->getValue();
+ try {
+ $cursorDocument = $dbForProject->findOne('attributes', [
+ Query::equal('databaseInternalId', [$database->getSequence()]),
+ Query::equal('collectionInternalId', [$collection->getSequence()]),
+ Query::equal('key', [$attributeId]),
+ ]);
+ } catch (QueryException $e) {
+ throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
+ }
+
+ if ($cursorDocument->isEmpty()) {
+ $type = ucfirst($this->getContext());
+ throw new Exception(Exception::GENERAL_CURSOR_NOT_FOUND, "$type '$attributeId' for the 'cursor' value not found.");
+ }
+
+ $cursor->setValue($cursorDocument);
+ }
+
+ try {
+ $attributes = $dbForProject->find('attributes', $queries);
+ $total = $dbForProject->count('attributes', $queries, APP_LIMIT_COUNT);
+ } catch (OrderException $e) {
+ $documents = $this->isCollectionsAPI() ? 'documents' : 'rows';
+ $attribute = $this->isCollectionsAPI() ? 'attribute' : 'column';
+ $message = "The order $attribute '{$e->getAttribute()}' had a null value. Cursor pagination requires all $documents order $attribute values are non-null.";
+ throw new Exception(Exception::DATABASE_QUERY_ORDER_NULL, $message);
+ } catch (QueryException) {
+ throw new Exception(Exception::GENERAL_QUERY_INVALID);
+ }
+
+ foreach ($attributes as $attribute) {
+ if ($attribute->getAttribute('type') === Database::VAR_STRING) {
+ $filters = $attribute->getAttribute('filters', []);
+ $attribute->setAttribute('encrypt', in_array('encrypt', $filters));
+ }
+ }
+
+ $response->dynamic(new Document([
+ 'total' => $total,
+ $this->getSdkGroup() => $attributes,
+ ]), $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Create.php
new file mode 100644
index 0000000000..176c3ca853
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Create.php
@@ -0,0 +1,133 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/collections')
+ ->desc('Create collections')
+ ->groups(['api', 'database'])
+ ->label('event', 'databases.[databaseId].collections.[collectionId].create')
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('audits.event', 'collection.create')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{response.$id}')
+ ->label('sdk', new Method(
+ namespace: 'databases',
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/create-collection.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_CREATED,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new CustomId(), 'Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can\'t start with a special char. Max length is 36 chars.')
+ ->param('name', '', new Text(128), 'Collection name. Max length: 128 chars.')
+ ->param('permissions', null, new Permissions(APP_LIMIT_ARRAY_PARAMS_SIZE), 'An array of permissions strings. By default, no user is granted with any permissions. [Learn more about permissions](https://appwrite.io/docs/permissions).', true)
+ ->param('documentSecurity', false, new Boolean(true), 'Enables configuring permissions for individual documents. A user needs one of document or collection level permissions to access a document. [Learn more about permissions](https://appwrite.io/docs/permissions).', true)
+ ->param('enabled', true, new Boolean(), 'Is collection enabled? When set to \'disabled\', users cannot access the collection but Server SDKs with and API key can still read and write to the collection. No data is lost when this is toggled.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $name, ?array $permissions, bool $documentSecurity, bool $enabled, UtopiaResponse $response, Database $dbForProject, Event $queueForEvents): void
+ {
+ $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
+
+ if ($database->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $collectionId = $collectionId === 'unique()' ? ID::unique() : $collectionId;
+
+ // Map aggregate permissions into the multiple permissions they represent.
+ $permissions = Permission::aggregate($permissions) ?? [];
+
+ try {
+ $collection = $dbForProject->createDocument('database_' . $database->getSequence(), new Document([
+ '$id' => $collectionId,
+ 'databaseInternalId' => $database->getSequence(),
+ 'databaseId' => $databaseId,
+ '$permissions' => $permissions,
+ 'documentSecurity' => $documentSecurity,
+ 'enabled' => $enabled,
+ 'name' => $name,
+ 'search' => \implode(' ', [$collectionId, $name]),
+ ]));
+ } catch (DuplicateException) {
+ throw new Exception($this->getDuplicateException());
+ } catch (LimitException) {
+ throw new Exception($this->getLimitException());
+ } catch (NotFoundException) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ try {
+ $dbForProject->createCollection(
+ id: 'database_' . $database->getSequence() . '_collection_' . $collection->getSequence(),
+ permissions: $permissions,
+ documentSecurity: $documentSecurity
+ );
+ } catch (DuplicateException) {
+ throw new Exception($this->getDuplicateException());
+ } catch (IndexException) {
+ throw new Exception($this->getInvalidIndexException());
+ } catch (LimitException) {
+ throw new Exception($this->getLimitException());
+ }
+
+ $queueForEvents
+ ->setContext('database', $database)
+ ->setParam('databaseId', $databaseId)
+ ->setParam($this->getEventsParamKey(), $collection->getId());
+
+ $response
+ ->setStatusCode(SwooleResponse::STATUS_CODE_CREATED)
+ ->dynamic($collection, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Delete.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Delete.php
new file mode 100644
index 0000000000..e4618a40b7
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Delete.php
@@ -0,0 +1,102 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_DELETE)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId')
+ ->desc('Delete collection')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].collections.[collectionId].delete')
+ ->label('audits.event', 'collection.delete')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('sdk', new Method(
+ namespace: 'databases',
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/delete-collection.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_NOCONTENT,
+ model: UtopiaResponse::MODEL_NONE,
+ )
+ ],
+ contentType: ContentType::NONE
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, UtopiaResponse $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents): void
+ {
+ $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
+ if ($database->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
+ if ($collection->isEmpty()) {
+ throw new Exception($this->getNotFoundException());
+ }
+
+ if (!$dbForProject->deleteDocument('database_' . $database->getSequence(), $collectionId)) {
+ $type = $this->getContext();
+ throw new Exception(Exception::GENERAL_SERVER_ERROR, "Failed to remove $type from DB");
+ }
+
+ $dbForProject->purgeCachedCollection('database_' . $database->getSequence() . '_collection_' . $collection->getSequence());
+
+ $queueForDatabase
+ ->setType(DATABASE_TYPE_DELETE_COLLECTION)
+ ->setDatabase($database);
+
+ if ($this->isCollectionsAPI()) {
+ $queueForDatabase->setCollection($collection);
+ } else {
+ $queueForDatabase->setTable($collection);
+ }
+
+ $queueForEvents
+ ->setParam('databaseId', $databaseId)
+ ->setContext('database', $database)
+ ->setParam($this->getEventsParamKey(), $collection->getId())
+ ->setPayload($response->output($collection, $this->getResponseModel()));
+
+ $response->noContent();
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Action.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Action.php
new file mode 100644
index 0000000000..bfebca4cf7
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Action.php
@@ -0,0 +1,282 @@
+context = ROWS;
+ }
+
+ return parent::setHttpPath($path);
+ }
+
+ /**
+ * Get the plural of the given name.
+ *
+ * Used for endpoints with multiple sdk methods.
+ */
+ final protected function getBulkActionName(string $name): string
+ {
+ return "{$name}s";
+ }
+
+ /**
+ * Get the current context.
+ */
+ final protected function getContext(): string
+ {
+ return $this->context;
+ }
+
+ /**
+ * Returns true if current context is Collections API.
+ */
+ final protected function isCollectionsAPI(): bool
+ {
+ // rows in tables api context
+ // documents in collections api context
+ return $this->getContext() === DOCUMENTS;
+ }
+
+ /**
+ * Get the SDK group name for the current action.
+ *
+ * Can be used for XList operations as well!
+ */
+ final protected function getSdkGroup(): string
+ {
+ return $this->isCollectionsAPI() ? 'documents' : 'rows';
+ }
+
+ /**
+ * Get the SDK namespace for the current action.
+ */
+ final protected function getSdkNamespace(): string
+ {
+ return $this->isCollectionsAPI() ? 'databases' : 'tables';
+ }
+
+ /**
+ * Get the correct attribute/column structure context for errors.
+ */
+ final protected function getStructureContext(): string
+ {
+ return $this->isCollectionsAPI() ? 'attributes' : 'columns';
+ }
+
+ /**
+ * Get the appropriate parent level not found exception.
+ */
+ final protected function getParentNotFoundException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::COLLECTION_NOT_FOUND
+ : Exception::TABLE_NOT_FOUND;
+ }
+
+ /**
+ * Get the appropriate attribute/column not found exception.
+ */
+ final protected function getStructureNotFoundException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::ATTRIBUTE_NOT_FOUND
+ : Exception::COLUMN_NOT_FOUND;
+ }
+
+ /**
+ * Get the appropriate not found exception.
+ */
+ final protected function getNotFoundException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::DOCUMENT_NOT_FOUND
+ : Exception::ROW_NOT_FOUND;
+ }
+
+ /**
+ * Get the appropriate already exists exception.
+ */
+ final protected function getDuplicateException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::DOCUMENT_ALREADY_EXISTS
+ : Exception::ROW_ALREADY_EXISTS;
+ }
+
+ /**
+ * Get the appropriate conflict exception.
+ */
+ final protected function getConflictException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::DOCUMENT_UPDATE_CONFLICT
+ : Exception::ROW_UPDATE_CONFLICT;
+ }
+
+ /**
+ * Get the appropriate delete restricted exception.
+ */
+ final protected function getRestrictedException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::DOCUMENT_DELETE_RESTRICTED
+ : Exception::ROW_DELETE_RESTRICTED;
+ }
+
+ /**
+ * Get the correct invalid structure message.
+ */
+ final protected function getInvalidStructureException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::DOCUMENT_INVALID_STRUCTURE
+ : Exception::ROW_INVALID_STRUCTURE;
+ }
+
+ /**
+ * Get the appropriate missing data exception.
+ */
+ final protected function getMissingDataException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::DOCUMENT_MISSING_DATA
+ : Exception::ROW_MISSING_DATA;
+ }
+
+ /**
+ * Get the exception to throw when the resource limit is exceeded.
+ */
+ final protected function getLimitException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::ATTRIBUTE_LIMIT_EXCEEDED
+ : Exception::COLUMN_LIMIT_EXCEEDED;
+ }
+
+ /**
+ * Get the appropriate missing payload exception.
+ */
+ final protected function getMissingPayloadException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::DOCUMENT_MISSING_PAYLOAD
+ : Exception::ROW_MISSING_PAYLOAD;
+ }
+
+ /**
+ * Get the correct collections context for Events queue.
+ */
+ final protected function getCollectionsEventsContext(): string
+ {
+ return $this->isCollectionsAPI() ? 'collection' : 'table';
+ }
+
+ /**
+ * Resolves relationships in a document and attaches metadata.
+ */
+ final protected function processDocument(
+ /* database */
+ Document $database,
+ Document $collection,
+ Document $document,
+ Database $dbForProject,
+
+ /* options */
+ array &$collectionsCache,
+ ?int &$operations = null,
+ ): bool {
+
+ if ($operations !== null && $document->isEmpty()) {
+ return false;
+ }
+
+ if ($operations !== null) {
+ $operations++;
+ }
+
+ $collectionId = $collection->getId();
+ $document->removeAttribute('$collection');
+ $document->setAttribute('$databaseId', $database->getId());
+ $document->setAttribute('$collectionId', $collectionId);
+
+ $relationships = $collectionsCache[$collectionId] ??= \array_filter(
+ $collection->getAttribute('attributes', []),
+ fn ($attr) => $attr->getAttribute('type') === Database::VAR_RELATIONSHIP
+ );
+
+ foreach ($relationships as $relationship) {
+ $key = $relationship->getAttribute('key');
+ $related = $document->getAttribute($key);
+
+ if (empty($related)) {
+ if (\in_array(\gettype($related), ['array', 'object']) && $operations !== null) {
+ $operations++;
+ }
+ continue;
+ }
+
+ $relations = \is_array($related) ? $related : [$related];
+ $relatedCollectionId = $relationship->getAttribute('relatedCollection');
+
+ if (!isset($collectionsCache[$relatedCollectionId])) {
+ $relatedCollectionDoc = Authorization::skip(
+ fn () => $dbForProject->getDocument(
+ 'database_' . $database->getSequence(),
+ $relatedCollectionId
+ )
+ );
+
+ $collectionsCache[$relatedCollectionId] = \array_filter(
+ $relatedCollectionDoc->getAttribute('attributes', []),
+ fn ($attr) => $attr->getAttribute('type') === Database::VAR_RELATIONSHIP
+ );
+ }
+
+ foreach ($relations as $relation) {
+ if ($relation instanceof Document) {
+ $relatedCollection = new Document([
+ '$id' => $relatedCollectionId,
+ 'attributes' => $collectionsCache[$relatedCollectionId],
+ ]);
+
+ $this->processDocument(
+ database: $database,
+ collection: $relatedCollection,
+ document: $relation,
+ dbForProject: $dbForProject,
+ collectionsCache: $collectionsCache,
+ operations: $operations
+ );
+ }
+ }
+
+ if (\is_array($related)) {
+ $document->setAttribute($relationship->getAttribute('key'), \array_values($relations));
+ } elseif (empty($relations)) {
+ $document->setAttribute($relationship->getAttribute('key'), null);
+ }
+ }
+
+ return true;
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Attribute/Decrement.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Attribute/Decrement.php
new file mode 100644
index 0000000000..40035ac302
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Attribute/Decrement.php
@@ -0,0 +1,122 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/documents/:documentId/:attribute/decrement')
+ ->desc('Decrement document attribute')
+ ->groups(['api', 'database'])
+ ->label('event', 'databases.[databaseId].collections.[collectionId].documents.[documentId].decrement')
+ ->label('scope', 'documents.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('audits.event', 'documents.decrement')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
+ ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT * 2)
+ ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/decrement-document-attribute.md',
+ auth: [AuthType::ADMIN, AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('documentId', '', new UID(), 'Document ID.')
+ ->param('attribute', '', new Key(), 'Attribute key.')
+ ->param('value', 1, new Numeric(), 'Value to increment the attribute by. The value must be a number.', true)
+ ->param('min', null, new Numeric(), 'Minimum value for the attribute. If the current value is lesser than this value, an exception will be thrown.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->inject('queueForStatsUsage')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $documentId, string $attribute, int|float $value, int|float|null $min, UtopiaResponse $response, Database $dbForProject, Event $queueForEvents, StatsUsage $queueForStatsUsage): void
+ {
+ $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
+ if ($database->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $collection = Authorization::skip(fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId));
+ if ($collection->isEmpty()) {
+ throw new Exception($this->getParentNotFoundException());
+ }
+
+ try {
+ $document = $dbForProject->decreaseDocumentAttribute(
+ collection: 'database_' . $database->getSequence() . '_collection_' . $collection->getSequence(),
+ id: $documentId,
+ attribute: $attribute,
+ value: $value,
+ min: $min
+ );
+ } catch (ConflictException) {
+ throw new Exception($this->getConflictException());
+ } catch (NotFoundException) {
+ throw new Exception($this->getStructureNotFoundException());
+ } catch (LimitException) {
+ throw new Exception($this->getLimitException(), $this->getSdkNamespace() . ' "' . $attribute . '" has reached the minimum value of ' . $min);
+ } catch (TypeException) {
+ throw new Exception(Exception::ATTRIBUTE_TYPE_INVALID, $this->getSdkNamespace() . ' "' . $attribute . '" is not a number');
+ }
+
+ $queueForStatsUsage
+ ->addMetric(METRIC_DATABASES_OPERATIONS_WRITES, 1)
+ ->addMetric(str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_OPERATIONS_WRITES), 1);
+
+ $queueForEvents
+ ->setParam('databaseId', $databaseId)
+ ->setContext('database', $database)
+ ->setParam('collectionId', $collectionId)
+ ->setParam('tableId', $collectionId)
+ ->setContext($this->getCollectionsEventsContext(), $collection);
+
+ $response->dynamic($document, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Attribute/Increment.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Attribute/Increment.php
new file mode 100644
index 0000000000..6755d313c0
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Attribute/Increment.php
@@ -0,0 +1,122 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/documents/:documentId/:attribute/increment')
+ ->desc('Increment document attribute')
+ ->groups(['api', 'database'])
+ ->label('event', 'databases.[databaseId].collections.[collectionId].documents.[documentId].increment')
+ ->label('scope', 'documents.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('audits.event', 'documents.increment')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
+ ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT * 2)
+ ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/increment-document-attribute.md',
+ auth: [AuthType::ADMIN, AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('documentId', '', new UID(), 'Document ID.')
+ ->param('attribute', '', new Key(), 'Attribute key.')
+ ->param('value', 1, new Numeric(), 'Value to increment the attribute by. The value must be a number.', true)
+ ->param('max', null, new Numeric(), 'Maximum value for the attribute. If the current value is greater than this value, an error will be thrown.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->inject('queueForStatsUsage')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $documentId, string $attribute, int|float $value, int|float|null $max, UtopiaResponse $response, Database $dbForProject, Event $queueForEvents, StatsUsage $queueForStatsUsage): void
+ {
+ $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
+ if ($database->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $collection = Authorization::skip(fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId));
+ if ($collection->isEmpty()) {
+ throw new Exception($this->getParentNotFoundException());
+ }
+
+ try {
+ $document = $dbForProject->increaseDocumentAttribute(
+ collection: 'database_' . $database->getSequence() . '_collection_' . $collection->getSequence(),
+ id: $documentId,
+ attribute: $attribute,
+ value: $value,
+ max: $max
+ );
+ } catch (ConflictException) {
+ throw new Exception($this->getConflictException());
+ } catch (NotFoundException) {
+ throw new Exception($this->getStructureNotFoundException());
+ } catch (LimitException) {
+ throw new Exception($this->getLimitException(), $this->getSdkNamespace() . ' "' . $attribute . '" has reached the maximum value of ' . $max);
+ } catch (TypeException) {
+ throw new Exception(Exception::ATTRIBUTE_TYPE_INVALID, $this->getSdkNamespace() . ' "' . $attribute . '" is not a number');
+ }
+
+ $queueForStatsUsage
+ ->addMetric(METRIC_DATABASES_OPERATIONS_WRITES, 1)
+ ->addMetric(str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_OPERATIONS_WRITES), 1);
+
+ $queueForEvents
+ ->setParam('databaseId', $databaseId)
+ ->setContext('database', $database)
+ ->setParam('collectionId', $collectionId)
+ ->setParam('tableId', $collectionId)
+ ->setContext($this->getCollectionsEventsContext(), $collection);
+
+ $response->dynamic($document, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Bulk/Delete.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Bulk/Delete.php
new file mode 100644
index 0000000000..4ec852f7c5
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Bulk/Delete.php
@@ -0,0 +1,133 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_DELETE)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/documents')
+ ->desc('Delete documents')
+ ->groups(['api', 'database'])
+ ->label('scope', 'documents.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('audits.event', 'documents.delete')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
+ ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT)
+ ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/delete-documents.md',
+ auth: [AuthType::ADMIN, AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
+ ->param('queries', [], new ArrayList(new Text(APP_LIMIT_ARRAY_ELEMENT_SIZE), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForStatsUsage')
+ ->inject('plan')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, array $queries, UtopiaResponse $response, Database $dbForProject, StatsUsage $queueForStatsUsage, array $plan): void
+ {
+ $database = $dbForProject->getDocument('databases', $databaseId);
+ if ($database->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
+ if ($collection->isEmpty()) {
+ throw new Exception($this->getParentNotFoundException());
+ }
+
+ $hasRelationships = \array_filter(
+ $collection->getAttribute('attributes', []),
+ fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
+ );
+
+ if ($hasRelationships) {
+ throw new Exception(Exception::GENERAL_BAD_REQUEST, 'Bulk delete is not supported for ' . $this->getSdkNamespace() . ' with relationship attributes');
+ }
+
+ try {
+ $queries = Query::parseQueries($queries);
+ } catch (QueryException $e) {
+ throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
+ }
+
+ $documents = [];
+
+ try {
+ $modified = $dbForProject->deleteDocuments(
+ 'database_' . $database->getSequence() . '_collection_' . $collection->getSequence(),
+ $queries,
+ onNext: function (Document $document) use ($plan, &$documents) {
+ if (\count($documents) < ($plan['databasesBatchSize'] ?? APP_LIMIT_DATABASE_BATCH)) {
+ $documents[] = $document;
+ }
+ },
+ );
+ } catch (ConflictException) {
+ throw new Exception($this->getConflictException());
+ } catch (RestrictedException) {
+ throw new Exception($this->getRestrictedException());
+ }
+
+ foreach ($documents as $document) {
+ $document->setAttribute('$databaseId', $database->getId());
+ $document->setAttribute('$collectionId', $collection->getId());
+ }
+
+ $queueForStatsUsage
+ ->addMetric(METRIC_DATABASES_OPERATIONS_WRITES, \max(1, $modified))
+ ->addMetric(str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_OPERATIONS_WRITES), \max(1, $modified));
+
+ $response->dynamic(new Document([
+ 'total' => $modified,
+ $this->getSdkGroup() => $documents,
+ ]), $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Bulk/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Bulk/Update.php
new file mode 100644
index 0000000000..d391c805fa
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Bulk/Update.php
@@ -0,0 +1,155 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/documents')
+ ->desc('Update documents')
+ ->groups(['api', 'database'])
+ ->label('scope', 'documents.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('audits.event', 'documents.update')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
+ ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT * 2)
+ ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/update-documents.md',
+ auth: [AuthType::ADMIN, AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('data', [], new JSON(), 'Document data as JSON object. Include only attribute and value pairs to be updated.', true)
+ ->param('queries', [], new ArrayList(new Text(APP_LIMIT_ARRAY_ELEMENT_SIZE), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForStatsUsage')
+ ->inject('plan')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string|array $data, array $queries, UtopiaResponse $response, Database $dbForProject, StatsUsage $queueForStatsUsage, array $plan): void
+ {
+ $data = \is_string($data)
+ ? \json_decode($data, true)
+ : $data;
+
+ if (empty($data)) {
+ throw new Exception($this->getMissingPayloadException());
+ }
+
+ $database = $dbForProject->getDocument('databases', $databaseId);
+ if ($database->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
+ if ($collection->isEmpty()) {
+ throw new Exception($this->getParentNotFoundException());
+ }
+
+ $hasRelationships = \array_filter(
+ $collection->getAttribute('attributes', []),
+ fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
+ );
+
+ if ($hasRelationships) {
+ throw new Exception(Exception::GENERAL_BAD_REQUEST, 'Bulk update is not supported for ' . $this->getSdkNamespace() . ' with relationship attributes');
+ }
+
+ try {
+ $queries = Query::parseQueries($queries);
+ } catch (QueryException $e) {
+ throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
+ }
+
+ if ($data['$permissions']) {
+ $validator = new Permissions();
+ if (!$validator->isValid($data['$permissions'])) {
+ throw new Exception(Exception::GENERAL_BAD_REQUEST, $validator->getDescription());
+ }
+ }
+
+ $documents = [];
+
+ try {
+ $modified = $dbForProject->updateDocuments(
+ 'database_' . $database->getSequence() . '_collection_' . $collection->getSequence(),
+ new Document($data),
+ $queries,
+ onNext: function (Document $document) use ($plan, &$documents) {
+ if (\count($documents) < ($plan['databasesBatchSize'] ?? APP_LIMIT_DATABASE_BATCH)) {
+ $documents[] = $document;
+ }
+ },
+ );
+ } catch (ConflictException) {
+ throw new Exception($this->getConflictException());
+ } catch (RelationshipException $e) {
+ throw new Exception(Exception::RELATIONSHIP_VALUE_INVALID, $e->getMessage());
+ } catch (StructureException $e) {
+ throw new Exception($this->getInvalidStructureException(), $e->getMessage());
+ }
+
+ foreach ($documents as $document) {
+ $document->setAttribute('$databaseId', $database->getId());
+ $document->setAttribute('$collectionId', $collection->getId());
+ }
+
+ $queueForStatsUsage
+ ->addMetric(METRIC_DATABASES_OPERATIONS_WRITES, \max(1, $modified))
+ ->addMetric(str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_OPERATIONS_WRITES), \max(1, $modified));
+
+ $response->dynamic(new Document([
+ 'total' => $modified,
+ $this->getSdkGroup() => $documents
+ ]), $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Bulk/Upsert.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Bulk/Upsert.php
new file mode 100644
index 0000000000..f4c8c2e6d2
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Bulk/Upsert.php
@@ -0,0 +1,137 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PUT)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/documents')
+ ->desc('Create or update documents')
+ ->groups(['api', 'database'])
+ ->label('scope', 'documents.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('audits.event', 'document.create')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
+ ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT * 2)
+ ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
+ ->label('sdk', [
+ new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/upsert-documents.md',
+ auth: [AuthType::ADMIN, AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_CREATED,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON,
+ )
+ ])
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('documents', [], fn (array $plan) => new ArrayList(new JSON(), $plan['databasesBatchSize'] ?? APP_LIMIT_DATABASE_BATCH), 'Array of document data as JSON objects. May contain partial documents.', false, ['plan'])
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForStatsUsage')
+ ->inject('plan')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, array $documents, UtopiaResponse $response, Database $dbForProject, StatsUsage $queueForStatsUsage, array $plan): void
+ {
+ $database = $dbForProject->getDocument('databases', $databaseId);
+ if ($database->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
+ if ($collection->isEmpty()) {
+ throw new Exception($this->getParentNotFoundException());
+ }
+
+ $hasRelationships = \array_filter(
+ $collection->getAttribute('attributes', []),
+ fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
+ );
+
+ if ($hasRelationships) {
+ throw new Exception(Exception::GENERAL_BAD_REQUEST, 'Bulk upsert is not supported for ' . $this->getSdkNamespace() . ' with relationship attributes');
+ }
+
+ foreach ($documents as $key => $document) {
+ $documents[$key] = new Document($document);
+ }
+
+ $upserted = [];
+
+ try {
+ $modified = $dbForProject->createOrUpdateDocuments(
+ 'database_' . $database->getSequence() . '_collection_' . $collection->getSequence(),
+ $documents,
+ onNext: function (Document $document) use ($plan, &$upserted) {
+ if (\count($upserted) < ($plan['databasesBatchSize'] ?? APP_LIMIT_DATABASE_BATCH)) {
+ $upserted[] = $document;
+ }
+ },
+ );
+ } catch (ConflictException) {
+ throw new Exception($this->getConflictException());
+ } catch (DuplicateException) {
+ throw new Exception($this->getDuplicateException());
+ } catch (RelationshipException $e) {
+ throw new Exception(Exception::RELATIONSHIP_VALUE_INVALID, $e->getMessage());
+ } catch (StructureException $e) {
+ throw new Exception($this->getInvalidStructureException(), $e->getMessage());
+ }
+
+ foreach ($upserted as $document) {
+ $document->setAttribute('$databaseId', $database->getId());
+ $document->setAttribute('$collectionId', $collection->getId());
+ }
+
+ $queueForStatsUsage
+ ->addMetric(METRIC_DATABASES_OPERATIONS_WRITES, \max(1, $modified))
+ ->addMetric(str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_OPERATIONS_WRITES), \max(1, $modified));
+
+ $response->dynamic(new Document([
+ 'total' => $modified,
+ $this->getSdkGroup() => $upserted
+ ]), $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Create.php
new file mode 100644
index 0000000000..6c1fdae5e6
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Create.php
@@ -0,0 +1,410 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/documents')
+ ->desc('Create document')
+ ->groups(['api', 'database'])
+ ->label('scope', 'documents.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('audits.event', 'document.create')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
+ ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT * 2)
+ ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
+ ->label('sdk', [
+ new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/create-document.md',
+ auth: [AuthType::SESSION, AuthType::KEY, AuthType::JWT],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_CREATED,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON,
+ parameters: [
+ new Parameter('databaseId', optional: false),
+ new Parameter('collectionId', optional: false),
+ new Parameter('documentId', optional: false),
+ new Parameter('data', optional: false),
+ new Parameter('permissions', optional: true),
+ ]
+ ),
+ new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: $this->getBulkActionName(self::getName()),
+ description: '/docs/references/databases/create-documents.md',
+ auth: [AuthType::ADMIN, AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_CREATED,
+ model: $this->getBulkResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON,
+ parameters: [
+ new Parameter('databaseId', optional: false),
+ new Parameter('collectionId', optional: false),
+ new Parameter('documents', optional: false),
+ ]
+ )
+ ])
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('documentId', '', new CustomId(), 'Document ID. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can\'t start with a special char. Max length is 36 chars.', true)
+ ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection). Make sure to define attributes before creating documents.')
+ ->param('data', [], new JSON(), 'Document data as JSON object.', true)
+ ->param('permissions', null, new Permissions(APP_LIMIT_ARRAY_PARAMS_SIZE, [Database::PERMISSION_READ, Database::PERMISSION_UPDATE, Database::PERMISSION_DELETE, Database::PERMISSION_WRITE]), 'An array of permissions strings. By default, only the current user is granted all permissions. [Learn more about permissions](https://appwrite.io/docs/permissions).', true)
+ ->param('documents', [], fn (array $plan) => new ArrayList(new JSON(), $plan['databasesBatchSize'] ?? APP_LIMIT_DATABASE_BATCH), 'Array of documents data as JSON objects.', true, ['plan'])
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('user')
+ ->inject('queueForEvents')
+ ->inject('queueForStatsUsage')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $documentId, string $collectionId, string|array $data, ?array $permissions, ?array $documents, UtopiaResponse $response, Database $dbForProject, Document $user, Event $queueForEvents, StatsUsage $queueForStatsUsage): void
+ {
+ $data = \is_string($data)
+ ? \json_decode($data, true)
+ : $data;
+
+ /**
+ * Determine which internal path to call, single or bulk
+ */
+ if (empty($data) && empty($documents)) {
+ // No single or bulk documents provided
+ throw new Exception($this->getMissingDataException());
+ }
+ if (!empty($data) && !empty($documents)) {
+ // Both single and bulk documents provided
+ throw new Exception(Exception::GENERAL_BAD_REQUEST, 'You can only send one of the following parameters: data, ' . $this->getSdkGroup());
+ }
+ if (!empty($data) && empty($documentId)) {
+ // Single document provided without document ID
+ $document = $this->isCollectionsAPI() ? 'Document' : 'Row';
+ $message = "$document ID is required when creating a single " . strtolower($document) . '.';
+ throw new Exception($this->getMissingDataException(), $message);
+ }
+ if (!empty($documents) && !empty($documentId)) {
+ // Bulk documents provided with document ID
+ $documentId = $this->isCollectionsAPI() ? 'documentId' : 'rowId';
+ throw new Exception(
+ Exception::GENERAL_BAD_REQUEST,
+ "Param \"$documentId\" is not allowed when creating multiple " . $this->getSdkGroup() . ', set "$id" on each instead.'
+ );
+ }
+ if (!empty($documents) && !empty($permissions)) {
+ // Bulk documents provided with permissions
+ throw new Exception(Exception::GENERAL_BAD_REQUEST, 'Param "permissions" is disallowed when creating multiple ' . $this->getSdkGroup() . ', set "$permissions" on each instead');
+ }
+
+ $isBulk = true;
+ if (!empty($data)) {
+ // Single document provided, convert to single item array
+ // But remember that it was single to respond with a single document
+ $isBulk = false;
+ $documents = [$data];
+ }
+
+ $isAPIKey = Auth::isAppUser(Authorization::getRoles());
+ $isPrivilegedUser = Auth::isPrivilegedUser(Authorization::getRoles());
+
+ if ($isBulk && !$isAPIKey && !$isPrivilegedUser) {
+ throw new Exception(Exception::GENERAL_UNAUTHORIZED_SCOPE);
+ }
+
+ $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
+ if ($database->isEmpty() || (!$database->getAttribute('enabled', false) && !$isAPIKey && !$isPrivilegedUser)) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $collection = Authorization::skip(fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId));
+ if ($collection->isEmpty() || (!$collection->getAttribute('enabled', false) && !$isAPIKey && !$isPrivilegedUser)) {
+ throw new Exception($this->getParentNotFoundException());
+ }
+
+ $hasRelationships = \array_filter(
+ $collection->getAttribute('attributes', []),
+ fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
+ );
+
+ if ($isBulk && $hasRelationships) {
+ throw new Exception(Exception::GENERAL_BAD_REQUEST, 'Bulk create is not supported for ' . $this->getSdkNamespace() .' with relationship ' . $this->getStructureContext());
+ }
+
+ $setPermissions = function (Document $document, ?array $permissions) use ($user, $isAPIKey, $isPrivilegedUser, $isBulk) {
+ $allowedPermissions = [
+ Database::PERMISSION_READ,
+ Database::PERMISSION_UPDATE,
+ Database::PERMISSION_DELETE,
+ ];
+
+ // If bulk, we need to validate permissions explicitly per document
+ if ($isBulk) {
+ $permissions = $document['$permissions'] ?? null;
+ if (!empty($permissions)) {
+ $validator = new Permissions();
+ if (!$validator->isValid($permissions)) {
+ throw new Exception(Exception::GENERAL_BAD_REQUEST, $validator->getDescription());
+ }
+ }
+ }
+
+ $permissions = Permission::aggregate($permissions, $allowedPermissions);
+
+ // Add permissions for current the user if none were provided.
+ if (\is_null($permissions)) {
+ $permissions = [];
+ if (!empty($user->getId())) {
+ foreach ($allowedPermissions as $permission) {
+ $permissions[] = (new Permission($permission, 'user', $user->getId()))->toString();
+ }
+ }
+ }
+
+ // Users can only manage their own roles, API keys and Admin users can manage any
+ if (!$isAPIKey && !$isPrivilegedUser) {
+ foreach (Database::PERMISSIONS as $type) {
+ foreach ($permissions as $permission) {
+ $permission = Permission::parse($permission);
+ if ($permission->getPermission() != $type) {
+ continue;
+ }
+ $role = (new Role(
+ $permission->getRole(),
+ $permission->getIdentifier(),
+ $permission->getDimension()
+ ))->toString();
+ if (!Authorization::isRole($role)) {
+ throw new Exception(Exception::USER_UNAUTHORIZED, 'Permissions must be one of: (' . \implode(', ', Authorization::getRoles()) . ')');
+ }
+ }
+ }
+ }
+
+ $document->setAttribute('$permissions', $permissions);
+ };
+
+ $operations = 0;
+
+ $checkPermissions = function (Document $collection, Document $document, string $permission) use (&$checkPermissions, $dbForProject, $database, &$operations) {
+ $operations++;
+
+ $documentSecurity = $collection->getAttribute('documentSecurity', false);
+ $validator = new Authorization($permission);
+
+ $valid = $validator->isValid($collection->getPermissionsByType($permission));
+ if (($permission === Database::PERMISSION_UPDATE && !$documentSecurity) || !$valid) {
+ throw new Exception(Exception::USER_UNAUTHORIZED);
+ }
+
+ if ($permission === Database::PERMISSION_UPDATE) {
+ $valid = $valid || $validator->isValid($document->getUpdate());
+ if ($documentSecurity && !$valid) {
+ throw new Exception(Exception::USER_UNAUTHORIZED);
+ }
+ }
+
+ $relationships = \array_filter(
+ $collection->getAttribute('attributes', []),
+ fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
+ );
+
+ foreach ($relationships as $relationship) {
+ $related = $document->getAttribute($relationship->getAttribute('key'));
+
+ if (empty($related)) {
+ continue;
+ }
+
+ $isList = \is_array($related) && \array_values($related) === $related;
+
+ if ($isList) {
+ $relations = $related;
+ } else {
+ $relations = [$related];
+ }
+
+ $relatedCollectionId = $relationship->getAttribute('relatedCollection');
+ $relatedCollection = Authorization::skip(
+ fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $relatedCollectionId)
+ );
+
+ foreach ($relations as &$relation) {
+ if (
+ \is_array($relation)
+ && \array_values($relation) !== $relation
+ && !isset($relation['$id'])
+ ) {
+ $relation['$id'] = ID::unique();
+ $relation = new Document($relation);
+ }
+ if ($relation instanceof Document) {
+ $current = Authorization::skip(
+ fn () => $dbForProject->getDocument('database_' . $database->getSequence() . '_collection_' . $relatedCollection->getSequence(), $relation->getId())
+ );
+
+ if ($current->isEmpty()) {
+ $type = Database::PERMISSION_CREATE;
+
+ if (isset($relation['$id']) && $relation['$id'] === 'unique()') {
+ $relation['$id'] = ID::unique();
+ }
+ } else {
+ $relation->removeAttribute('$collectionId');
+ $relation->removeAttribute('$databaseId');
+ $relation->setAttribute('$collection', $relatedCollection->getId());
+ $type = Database::PERMISSION_UPDATE;
+ }
+
+ $checkPermissions($relatedCollection, $relation, $type);
+ }
+ }
+
+ if ($isList) {
+ $document->setAttribute($relationship->getAttribute('key'), \array_values($relations));
+ } else {
+ $document->setAttribute($relationship->getAttribute('key'), \reset($relations));
+ }
+ }
+ };
+
+ $documents = \array_map(function ($document) use ($collection, $permissions, $checkPermissions, $isBulk, $documentId, $setPermissions) {
+ $document['$collection'] = $collection->getId();
+
+ // Determine the source ID depending on whether it's a bulk operation.
+ $sourceId = $isBulk
+ ? ($document['$id'] ?? ID::unique())
+ : $documentId;
+
+ // If bulk, we need to validate ID explicitly
+ if ($isBulk) {
+ $validator = new CustomId();
+ if (!$validator->isValid($sourceId)) {
+ throw new Exception(Exception::GENERAL_BAD_REQUEST, $validator->getDescription());
+ }
+ }
+
+ // Assign a unique ID if needed, otherwise use the provided ID.
+ $document['$id'] = $sourceId === 'unique()' ? ID::unique() : $sourceId;
+ $document = new Document($document);
+ $setPermissions($document, $permissions);
+ $checkPermissions($collection, $document, Database::PERMISSION_CREATE);
+
+ return $document;
+ }, $documents);
+
+ try {
+ $dbForProject->createDocuments(
+ 'database_' . $database->getSequence() . '_collection_' . $collection->getSequence(),
+ $documents
+ );
+ } catch (DuplicateException) {
+ throw new Exception($this->getDuplicateException());
+ } catch (NotFoundException) {
+ throw new Exception($this->getParentNotFoundException());
+ } catch (RelationshipException $e) {
+ throw new Exception(Exception::RELATIONSHIP_VALUE_INVALID, $e->getMessage());
+ } catch (StructureException $e) {
+ throw new Exception($this->getInvalidStructureException(), $e->getMessage());
+ }
+
+ $queueForEvents
+ ->setParam('databaseId', $databaseId)
+ ->setContext('database', $database)
+ ->setParam('collectionId', $collection->getId())
+ ->setParam('tableId', $collection->getId())
+ ->setContext($this->getCollectionsEventsContext(), $collection);
+
+ $collectionsCache = [];
+ foreach ($documents as $document) {
+ $this->processDocument(
+ database: $database,
+ collection: $collection,
+ document: $document,
+ dbForProject: $dbForProject,
+ collectionsCache: $collectionsCache,
+ );
+ }
+
+ $queueForStatsUsage
+ ->addMetric(METRIC_DATABASES_OPERATIONS_WRITES, \max(1, $operations))
+ ->addMetric(str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_OPERATIONS_WRITES), \max(1, $operations)); // per collection
+
+ $response->setStatusCode(SwooleResponse::STATUS_CODE_CREATED);
+
+
+ if ($isBulk) {
+ $response->dynamic(new Document([
+ 'total' => count($documents),
+ $this->getSdkGroup() => $documents
+ ]), $this->getBulkResponseModel());
+
+ return;
+ }
+
+ $queueForEvents
+ ->setParam('documentId', $documents[0]->getId())
+ ->setParam('rowId', $documents[0]->getId())
+ ->setEvent('databases.[databaseId].collections.[collectionId].documents.[documentId].create');
+
+ $response->dynamic(
+ $documents[0],
+ $this->getResponseModel()
+ );
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Delete.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Delete.php
new file mode 100644
index 0000000000..8c8cec2986
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Delete.php
@@ -0,0 +1,149 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_DELETE)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/documents/:documentId')
+ ->desc('Delete document')
+ ->groups(['api', 'database'])
+ ->label('scope', 'documents.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].collections.[collectionId].documents.[documentId].delete')
+ ->label('audits.event', 'document.delete')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}/document/{request.documentId}')
+ ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
+ ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT)
+ ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/delete-document.md',
+ auth: [AuthType::SESSION, AuthType::KEY, AuthType::JWT],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_NOCONTENT,
+ model: UtopiaResponse::MODEL_NONE,
+ )
+ ],
+ contentType: ContentType::NONE
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
+ ->param('documentId', '', new UID(), 'Document ID.')
+ ->inject('requestTimestamp')
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->inject('queueForStatsUsage')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $documentId, ?\DateTime $requestTimestamp, UtopiaResponse $response, Database $dbForProject, Event $queueForEvents, StatsUsage $queueForStatsUsage): void
+ {
+ $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
+
+ $isAPIKey = Auth::isAppUser(Authorization::getRoles());
+ $isPrivilegedUser = Auth::isPrivilegedUser(Authorization::getRoles());
+
+ if ($database->isEmpty() || (!$database->getAttribute('enabled', false) && !$isAPIKey && !$isPrivilegedUser)) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $collection = Authorization::skip(fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId));
+
+ if ($collection->isEmpty() || (!$collection->getAttribute('enabled', false) && !$isAPIKey && !$isPrivilegedUser)) {
+ throw new Exception($this->getParentNotFoundException());
+ }
+
+ // Read permission should not be required for delete
+ $document = Authorization::skip(fn () => $dbForProject->getDocument('database_' . $database->getSequence() . '_collection_' . $collection->getSequence(), $documentId));
+
+ if ($document->isEmpty()) {
+ throw new Exception($this->getNotFoundException());
+ }
+
+ try {
+ $dbForProject->withRequestTimestamp($requestTimestamp, function () use ($dbForProject, $database, $collection, $documentId) {
+ $dbForProject->deleteDocument(
+ 'database_' . $database->getSequence() . '_collection_' . $collection->getSequence(),
+ $documentId
+ );
+ });
+ } catch (ConflictException) {
+ throw new Exception($this->getConflictException());
+ } catch (RestrictedException) {
+ throw new Exception($this->getRestrictedException());
+ }
+
+ $collectionsCache = [];
+ $this->processDocument(
+ database: $database,
+ collection: $collection,
+ document: $document,
+ dbForProject: $dbForProject,
+ collectionsCache: $collectionsCache,
+ );
+
+ $queueForStatsUsage
+ ->addMetric(METRIC_DATABASES_OPERATIONS_WRITES, 1)
+ ->addMetric(str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_OPERATIONS_WRITES), 1); // per collection
+
+ $response->addHeader('X-Debug-Operations', 1);
+
+ $relationships = \array_map(
+ fn ($document) => $document->getAttribute('key'),
+ \array_filter(
+ $collection->getAttribute('attributes', []),
+ fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
+ )
+ );
+
+ $queueForEvents
+ ->setParam('databaseId', $databaseId)
+ ->setContext('database', $database)
+ ->setParam('collectionId', $collection->getId())
+ ->setParam('tableId', $collection->getId())
+ ->setParam('documentId', $document->getId())
+ ->setParam('rowId', $document->getId())
+ ->setContext($this->getCollectionsEventsContext(), $collection)
+ ->setPayload($response->output($document, $this->getResponseModel()), sensitive: $relationships);
+
+ $response->noContent();
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Get.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Get.php
new file mode 100644
index 0000000000..7376fe770a
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Get.php
@@ -0,0 +1,118 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/documents/:documentId')
+ ->desc('Get document')
+ ->groups(['api', 'database'])
+ ->label('scope', 'documents.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/get-document.md',
+ auth: [AuthType::SESSION, AuthType::KEY, AuthType::JWT],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
+ ->param('documentId', '', new UID(), 'Document ID.')
+ ->param('queries', [], new ArrayList(new Text(APP_LIMIT_ARRAY_ELEMENT_SIZE), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForStatsUsage')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $documentId, array $queries, UtopiaResponse $response, Database $dbForProject, StatsUsage $queueForStatsUsage): void
+ {
+ $isAPIKey = Auth::isAppUser(Authorization::getRoles());
+ $isPrivilegedUser = Auth::isPrivilegedUser(Authorization::getRoles());
+
+ $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
+ if ($database->isEmpty() || (!$database->getAttribute('enabled', false) && !$isAPIKey && !$isPrivilegedUser)) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $collection = Authorization::skip(fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId));
+
+ if ($collection->isEmpty() || (!$collection->getAttribute('enabled', false) && !$isAPIKey && !$isPrivilegedUser)) {
+ throw new Exception($this->getParentNotFoundException());
+ }
+
+ try {
+ $queries = Query::parseQueries($queries);
+ } catch (QueryException $e) {
+ throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
+ }
+
+ try {
+ $document = $dbForProject->getDocument('database_' . $database->getSequence() . '_collection_' . $collection->getSequence(), $documentId, $queries);
+ } catch (QueryException $e) {
+ throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
+ }
+
+ if ($document->isEmpty()) {
+ throw new Exception($this->getNotFoundException());
+ }
+
+ $operations = 0;
+ $collectionsCache = [];
+ $this->processDocument(
+ database: $database,
+ collection: $collection,
+ document: $document,
+ dbForProject: $dbForProject,
+ collectionsCache: $collectionsCache,
+ operations: $operations
+ );
+
+ $queueForStatsUsage
+ ->addMetric(METRIC_DATABASES_OPERATIONS_READS, max($operations, 1))
+ ->addMetric(str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_OPERATIONS_READS), $operations);
+
+ $response->addHeader('X-Debug-Operations', $operations);
+
+ $response->dynamic($document, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Logs/XList.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Logs/XList.php
new file mode 100644
index 0000000000..3fe25b9441
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Logs/XList.php
@@ -0,0 +1,158 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/documents/:documentId/logs')
+ ->desc('List document logs')
+ ->groups(['api', 'database'])
+ ->label('scope', 'documents.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: 'logs',
+ name: self::getName(),
+ description: '/docs/references/databases/get-document-logs.md',
+ auth: [AuthType::ADMIN],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON,
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('documentId', '', new UID(), 'Document ID.')
+ ->param('queries', [], new Queries([new Limit(), new Offset()]), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Only supported methods are limit and offset', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('locale')
+ ->inject('geodb')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $documentId, array $queries, UtopiaResponse $response, Database $dbForProject, Locale $locale, Reader $geodb): void
+ {
+ $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
+ if ($database->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
+ if ($collection->isEmpty()) {
+ throw new Exception($this->getParentNotFoundException());
+ }
+
+ $document = $dbForProject->getDocument('database_' . $database->getSequence() . '_collection_' . $collection->getSequence(), $documentId);
+ if ($document->isEmpty()) {
+ throw new Exception($this->getNotFoundException());
+ }
+
+ try {
+ $queries = Query::parseQueries($queries);
+ } catch (QueryException $e) {
+ throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
+ }
+
+ // Temp fix for logs
+ $queries[] = Query::or([
+ Query::greaterThan('$createdAt', DateTime::format(new \DateTime('2025-02-26T01:30+00:00'))),
+ Query::lessThan('$createdAt', DateTime::format(new \DateTime('2025-02-13T00:00+00:00'))),
+ ]);
+
+ $audit = new Audit($dbForProject);
+ // getContext() => `document` or `row`.
+ $resource = 'database/' . $databaseId . '/collection/' . $collectionId . '/' .$this->getContext(). '/' . $document->getId();
+ $logs = $audit->getLogsByResource($resource, $queries);
+
+ $output = [];
+
+ foreach ($logs as $i => &$log) {
+ $log['userAgent'] = (!empty($log['userAgent'])) ? $log['userAgent'] : 'UNKNOWN';
+
+ $detector = new Detector($log['userAgent']);
+ $detector->skipBotDetection(); // OPTIONAL: If called, bot detection will completely be skipped (bots will be detected as regular devices then)
+
+ $os = $detector->getOS();
+ $client = $detector->getClient();
+ $device = $detector->getDevice();
+
+ $output[$i] = new Document([
+ 'event' => $log['event'],
+ 'userId' => $log['data']['userId'],
+ 'userEmail' => $log['data']['userEmail'] ?? null,
+ 'userName' => $log['data']['userName'] ?? null,
+ 'mode' => $log['data']['mode'] ?? null,
+ 'ip' => $log['ip'],
+ 'time' => $log['time'],
+ 'osCode' => $os['osCode'],
+ 'osName' => $os['osName'],
+ 'osVersion' => $os['osVersion'],
+ 'clientType' => $client['clientType'],
+ 'clientCode' => $client['clientCode'],
+ 'clientName' => $client['clientName'],
+ 'clientVersion' => $client['clientVersion'],
+ 'clientEngine' => $client['clientEngine'],
+ 'clientEngineVersion' => $client['clientEngineVersion'],
+ 'deviceName' => $device['deviceName'],
+ 'deviceBrand' => $device['deviceBrand'],
+ 'deviceModel' => $device['deviceModel']
+ ]);
+
+ $record = $geodb->get($log['ip']);
+
+ if ($record) {
+ $output[$i]['countryCode'] = $locale->getText('countries.' . strtolower($record['country']['iso_code']), false) ? \strtolower($record['country']['iso_code']) : '--';
+ $output[$i]['countryName'] = $locale->getText('countries.' . strtolower($record['country']['iso_code']), $locale->getText('locale.country.unknown'));
+ } else {
+ $output[$i]['countryCode'] = '--';
+ $output[$i]['countryName'] = $locale->getText('locale.country.unknown');
+ }
+ }
+
+ $response->dynamic(new Document([
+ 'logs' => $output,
+ 'total' => $audit->countLogsByResource($resource, $queries),
+ ]), $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Update.php
new file mode 100644
index 0000000000..ce822ca713
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Update.php
@@ -0,0 +1,276 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/documents/:documentId')
+ ->desc('Update document')
+ ->groups(['api', 'database'])
+ ->label('event', 'databases.[databaseId].collections.[collectionId].documents.[documentId].update')
+ ->label('scope', 'documents.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('audits.event', 'document.update')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}/document/{response.$id}')
+ ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
+ ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT * 2)
+ ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/update-document.md',
+ auth: [AuthType::SESSION, AuthType::KEY, AuthType::JWT],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('documentId', '', new UID(), 'Document ID.')
+ ->param('data', [], new JSON(), 'Document data as JSON object. Include only attribute and value pairs to be updated.', true)
+ ->param('permissions', null, new Permissions(APP_LIMIT_ARRAY_PARAMS_SIZE, [Database::PERMISSION_READ, Database::PERMISSION_UPDATE, Database::PERMISSION_DELETE, Database::PERMISSION_WRITE]), 'An array of permissions strings. By default, the current permissions are inherited. [Learn more about permissions](https://appwrite.io/docs/permissions).', true)
+ ->inject('requestTimestamp')
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->inject('queueForStatsUsage')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $documentId, string|array $data, ?array $permissions, ?\DateTime $requestTimestamp, UtopiaResponse $response, Database $dbForProject, Event $queueForEvents, StatsUsage $queueForStatsUsage): void
+ {
+
+ $data = (\is_string($data)) ? \json_decode($data, true) : $data; // Cast to JSON array
+
+ if (empty($data) && \is_null($permissions)) {
+ throw new Exception($this->getMissingPayloadException());
+ }
+
+ $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
+
+ $isAPIKey = Auth::isAppUser(Authorization::getRoles());
+ $isPrivilegedUser = Auth::isPrivilegedUser(Authorization::getRoles());
+
+ if ($database->isEmpty() || (!$database->getAttribute('enabled', false) && !$isAPIKey && !$isPrivilegedUser)) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $collection = Authorization::skip(fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId));
+
+ if ($collection->isEmpty() || (!$collection->getAttribute('enabled', false) && !$isAPIKey && !$isPrivilegedUser)) {
+ throw new Exception($this->getParentNotFoundException());
+ }
+
+ // Read permission should not be required for update
+ /** @var Document $document */
+ $document = Authorization::skip(fn () => $dbForProject->getDocument('database_' . $database->getSequence() . '_collection_' . $collection->getSequence(), $documentId));
+
+ if ($document->isEmpty()) {
+ throw new Exception($this->getNotFoundException());
+ }
+
+ // Map aggregate permissions into the multiple permissions they represent.
+ $permissions = Permission::aggregate($permissions, [
+ Database::PERMISSION_READ,
+ Database::PERMISSION_UPDATE,
+ Database::PERMISSION_DELETE,
+ ]);
+
+ // Users can only manage their own roles, API keys and Admin users can manage any
+ $roles = Authorization::getRoles();
+ if (!$isAPIKey && !$isPrivilegedUser && !\is_null($permissions)) {
+ foreach (Database::PERMISSIONS as $type) {
+ foreach ($permissions as $permission) {
+ $permission = Permission::parse($permission);
+ if ($permission->getPermission() != $type) {
+ continue;
+ }
+ $role = (new Role(
+ $permission->getRole(),
+ $permission->getIdentifier(),
+ $permission->getDimension()
+ ))->toString();
+ if (!Authorization::isRole($role)) {
+ throw new Exception(Exception::USER_UNAUTHORIZED, 'Permissions must be one of: (' . \implode(', ', $roles) . ')');
+ }
+ }
+ }
+ }
+
+ if (\is_null($permissions)) {
+ $permissions = $document->getPermissions() ?? [];
+ }
+
+ $data['$id'] = $documentId;
+ $data['$permissions'] = $permissions;
+ $newDocument = new Document($data);
+
+ $operations = 0;
+
+ $setCollection = (function (Document $collection, Document $document) use (&$setCollection, $dbForProject, $database, &$operations) {
+
+ $operations++;
+
+ $relationships = \array_filter(
+ $collection->getAttribute('attributes', []),
+ fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
+ );
+
+ foreach ($relationships as $relationship) {
+ $related = $document->getAttribute($relationship->getAttribute('key'));
+
+ if (empty($related)) {
+ continue;
+ }
+
+ $isList = \is_array($related) && \array_values($related) === $related;
+
+ if ($isList) {
+ $relations = $related;
+ } else {
+ $relations = [$related];
+ }
+
+ $relatedCollectionId = $relationship->getAttribute('relatedCollection');
+ $relatedCollection = Authorization::skip(
+ fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $relatedCollectionId)
+ );
+
+ foreach ($relations as &$relation) {
+ // If the relation is an array it can be either update or create a child document.
+ if (
+ \is_array($relation)
+ && \array_values($relation) !== $relation
+ && !isset($relation['$id'])
+ ) {
+ $relation['$id'] = ID::unique();
+ $relation = new Document($relation);
+ }
+ if ($relation instanceof Document) {
+ $oldDocument = Authorization::skip(fn () => $dbForProject->getDocument(
+ 'database_' . $database->getSequence() . '_collection_' . $relatedCollection->getSequence(),
+ $relation->getId()
+ ));
+ $relation->removeAttribute('$collectionId');
+ $relation->removeAttribute('$databaseId');
+ // Attribute $collection is required for Utopia.
+ $relation->setAttribute(
+ '$collection',
+ 'database_' . $database->getSequence() . '_collection_' . $relatedCollection->getSequence()
+ );
+
+ if ($oldDocument->isEmpty()) {
+ if (isset($relation['$id']) && $relation['$id'] === 'unique()') {
+ $relation['$id'] = ID::unique();
+ }
+ }
+ $setCollection($relatedCollection, $relation);
+ }
+ }
+
+ if ($isList) {
+ $document->setAttribute($relationship->getAttribute('key'), \array_values($relations));
+ } else {
+ $document->setAttribute($relationship->getAttribute('key'), \reset($relations));
+ }
+ }
+ });
+
+ $setCollection($collection, $newDocument);
+
+ $queueForStatsUsage
+ ->addMetric(METRIC_DATABASES_OPERATIONS_WRITES, max($operations, 1))
+ ->addMetric(str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_OPERATIONS_WRITES), $operations);
+
+ try {
+ $document = $dbForProject->withRequestTimestamp(
+ $requestTimestamp,
+ fn () => $dbForProject->updateDocument(
+ 'database_' . $database->getSequence() . '_collection_' . $collection->getSequence(),
+ $document->getId(),
+ $newDocument
+ )
+ );
+ } catch (ConflictException) {
+ throw new Exception($this->getConflictException());
+ } catch (DuplicateException) {
+ throw new Exception($this->getDuplicateException());
+ } catch (RelationshipException $e) {
+ throw new Exception(Exception::RELATIONSHIP_VALUE_INVALID, $e->getMessage());
+ } catch (StructureException $e) {
+ throw new Exception($this->getInvalidStructureException(), $e->getMessage());
+ }
+
+ $collectionsCache = [];
+ $this->processDocument(
+ database: $database,
+ collection: $collection,
+ document: $document,
+ dbForProject: $dbForProject,
+ collectionsCache: $collectionsCache,
+ );
+
+ $response->dynamic($document, $this->getResponseModel());
+
+ $relationships = \array_map(
+ fn ($document) => $document->getAttribute('key'),
+ \array_filter(
+ $collection->getAttribute('attributes', []),
+ fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
+ )
+ );
+
+ $queueForEvents
+ ->setParam('databaseId', $databaseId)
+ ->setContext('database', $database)
+ ->setParam('collectionId', $collection->getId())
+ ->setParam('tableId', $collection->getId())
+ ->setParam('documentId', $document->getId())
+ ->setParam('rowId', $document->getId())
+ ->setContext($this->getCollectionsEventsContext(), $collection)
+ ->setPayload($response->getPayload(), sensitive: $relationships);
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Upsert.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Upsert.php
new file mode 100644
index 0000000000..7a077fed0d
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/Upsert.php
@@ -0,0 +1,268 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PUT)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/documents/:documentId')
+ ->desc('Create or update a document')
+ ->groups(['api', 'database'])
+ ->label('event', 'databases.[databaseId].collections.[collectionId].documents.[documentId].upsert')
+ ->label('scope', 'documents.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('audits.event', 'document.upsert')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}/document/{response.$id}')
+ ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
+ ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT * 2)
+ ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
+ ->label('sdk', [
+ new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/upsert-document.md',
+ auth: [AuthType::SESSION, AuthType::KEY, AuthType::JWT],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_CREATED,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ),
+ ])
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('documentId', '', new CustomId(), 'Document ID.')
+ ->param('data', [], new JSON(), 'Document data as JSON object. Include all required attributes of the document to be created or updated.')
+ ->param('permissions', null, new Permissions(APP_LIMIT_ARRAY_PARAMS_SIZE, [Database::PERMISSION_READ, Database::PERMISSION_UPDATE, Database::PERMISSION_DELETE, Database::PERMISSION_WRITE]), 'An array of permissions strings. By default, the current permissions are inherited. [Learn more about permissions](https://appwrite.io/docs/permissions).', true)
+ ->inject('requestTimestamp')
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->inject('queueForStatsUsage')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $documentId, string|array $data, ?array $permissions, ?\DateTime $requestTimestamp, UtopiaResponse $response, Database $dbForProject, Event $queueForEvents, StatsUsage $queueForStatsUsage): void
+ {
+ $data = (\is_string($data)) ? \json_decode($data, true) : $data; // Cast to JSON array
+
+ if (empty($data) && \is_null($permissions)) {
+ throw new Exception($this->getMissingPayloadException());
+ }
+
+ $isAPIKey = Auth::isAppUser(Authorization::getRoles());
+ $isPrivilegedUser = Auth::isPrivilegedUser(Authorization::getRoles());
+
+ $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
+ if ($database->isEmpty() || (!$database->getAttribute('enabled', false) && !$isAPIKey && !$isPrivilegedUser)) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $collection = Authorization::skip(fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId));
+ if ($collection->isEmpty() || (!$collection->getAttribute('enabled', false) && !$isAPIKey && !$isPrivilegedUser)) {
+ throw new Exception($this->getParentNotFoundException());
+ }
+
+ // Map aggregate permissions into the multiple permissions they represent.
+ $permissions = Permission::aggregate($permissions, [
+ Database::PERMISSION_READ,
+ Database::PERMISSION_UPDATE,
+ Database::PERMISSION_DELETE,
+ ]);
+
+ // Users can only manage their own roles, API keys and Admin users can manage any
+ $roles = Authorization::getRoles();
+ if (!$isAPIKey && !$isPrivilegedUser && !\is_null($permissions)) {
+ foreach (Database::PERMISSIONS as $type) {
+ foreach ($permissions as $permission) {
+ $permission = Permission::parse($permission);
+ if ($permission->getPermission() != $type) {
+ continue;
+ }
+ $role = (new Role(
+ $permission->getRole(),
+ $permission->getIdentifier(),
+ $permission->getDimension()
+ ))->toString();
+ if (!Authorization::isRole($role)) {
+ throw new Exception(Exception::USER_UNAUTHORIZED, 'Permissions must be one of: (' . \implode(', ', $roles) . ')');
+ }
+ }
+ }
+ }
+
+ $data['$id'] = $documentId;
+ $data['$permissions'] = $permissions;
+ $newDocument = new Document($data);
+
+ $operations = 0;
+
+ $setCollection = (function (Document $collection, Document $document) use (&$setCollection, $dbForProject, $database, &$operations) {
+
+ $operations++;
+
+ $relationships = \array_filter(
+ $collection->getAttribute('attributes', []),
+ fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
+ );
+
+ foreach ($relationships as $relationship) {
+ $related = $document->getAttribute($relationship->getAttribute('key'));
+
+ if (empty($related)) {
+ continue;
+ }
+
+ $isList = \is_array($related) && \array_values($related) === $related;
+
+ if ($isList) {
+ $relations = $related;
+ } else {
+ $relations = [$related];
+ }
+
+ $relatedCollectionId = $relationship->getAttribute('relatedCollection');
+ $relatedCollection = Authorization::skip(
+ fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $relatedCollectionId)
+ );
+
+ foreach ($relations as &$relation) {
+ // If the relation is an array it can be either update or create a child document.
+ if (
+ \is_array($relation)
+ && \array_values($relation) !== $relation
+ && !isset($relation['$id'])
+ ) {
+ $relation['$id'] = ID::unique();
+ $relation = new Document($relation);
+ }
+ if ($relation instanceof Document) {
+ $oldDocument = Authorization::skip(fn () => $dbForProject->getDocument(
+ 'database_' . $database->getSequence() . '_collection_' . $relatedCollection->getSequence(),
+ $relation->getId()
+ ));
+ $relation->removeAttribute('$collectionId');
+ $relation->removeAttribute('$databaseId');
+ // Attribute $collection is required for Utopia.
+ $relation->setAttribute(
+ '$collection',
+ 'database_' . $database->getSequence() . '_collection_' . $relatedCollection->getSequence()
+ );
+
+ if ($oldDocument->isEmpty()) {
+ if (isset($relation['$id']) && $relation['$id'] === 'unique()') {
+ $relation['$id'] = ID::unique();
+ }
+ }
+ $setCollection($relatedCollection, $relation);
+ }
+ }
+
+ if ($isList) {
+ $document->setAttribute($relationship->getAttribute('key'), \array_values($relations));
+ } else {
+ $document->setAttribute($relationship->getAttribute('key'), \reset($relations));
+ }
+ }
+ });
+
+ $setCollection($collection, $newDocument);
+
+ $queueForStatsUsage
+ ->addMetric(METRIC_DATABASES_OPERATIONS_WRITES, \max(1, $operations))
+ ->addMetric(str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_OPERATIONS_WRITES), \max(1, $operations));
+
+ $upserted = [];
+ try {
+ $dbForProject->createOrUpdateDocuments(
+ 'database_' . $database->getSequence() . '_collection_' . $collection->getSequence(),
+ [$newDocument],
+ onNext: function (Document $document) use (&$upserted) {
+ $upserted[] = $document;
+ },
+ );
+ } catch (ConflictException) {
+ throw new Exception($this->getConflictException());
+ } catch (DuplicateException) {
+ throw new Exception($this->getDuplicateException());
+ } catch (RelationshipException $e) {
+ throw new Exception(Exception::RELATIONSHIP_VALUE_INVALID, $e->getMessage());
+ } catch (StructureException $e) {
+ throw new Exception($this->getInvalidStructureException(), $e->getMessage());
+ }
+
+ $collectionsCache = [];
+ $document = $upserted[0];
+ $this->processDocument(
+ database: $database,
+ collection: $collection,
+ document: $document,
+ dbForProject: $dbForProject,
+ collectionsCache: $collectionsCache,
+ );
+
+ $relationships = \array_map(
+ fn ($document) => $document->getAttribute('key'),
+ \array_filter(
+ $collection->getAttribute('attributes', []),
+ fn ($attribute) => $attribute->getAttribute('type') === Database::VAR_RELATIONSHIP
+ )
+ );
+
+ $queueForEvents
+ ->setParam('databaseId', $databaseId)
+ ->setContext('database', $database)
+ ->setParam('collectionId', $collection->getId())
+ ->setParam('tableId', $collection->getId())
+ ->setParam('documentId', $document->getId())
+ ->setParam('rowId', $document->getId())
+ ->setContext($this->getCollectionsEventsContext(), $collection)
+ ->setPayload($response->getPayload(), sensitive: $relationships);
+
+ $response->dynamic(
+ $document,
+ $this->getResponseModel()
+ );
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/XList.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/XList.php
new file mode 100644
index 0000000000..2e76942db1
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Documents/XList.php
@@ -0,0 +1,181 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/documents')
+ ->desc('List documents')
+ ->groups(['api', 'database'])
+ ->label('scope', 'documents.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/list-documents.md',
+ auth: [AuthType::SESSION, AuthType::KEY, AuthType::JWT],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
+ ->param('queries', [], new ArrayList(new Text(APP_LIMIT_ARRAY_ELEMENT_SIZE), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForStatsUsage')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, array $queries, UtopiaResponse $response, Database $dbForProject, StatsUsage $queueForStatsUsage): void
+ {
+ $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
+ $isAPIKey = Auth::isAppUser(Authorization::getRoles());
+ $isPrivilegedUser = Auth::isPrivilegedUser(Authorization::getRoles());
+
+ if ($database->isEmpty() || (!$database->getAttribute('enabled', false) && !$isAPIKey && !$isPrivilegedUser)) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $collection = Authorization::skip(fn () => $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId));
+
+ if ($collection->isEmpty() || (!$collection->getAttribute('enabled', false) && !$isAPIKey && !$isPrivilegedUser)) {
+ throw new Exception($this->getParentNotFoundException());
+ }
+
+ try {
+ $queries = Query::parseQueries($queries);
+ } catch (QueryException $e) {
+ throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
+ }
+
+ /**
+ * Get cursor document if there was a cursor query, we use array_filter and reset for reference $cursor to $queries
+ */
+ $cursor = \array_filter($queries, function ($query) {
+ return \in_array($query->getMethod(), [Query::TYPE_CURSOR_AFTER, Query::TYPE_CURSOR_BEFORE]);
+ });
+
+ $cursor = \reset($cursor);
+
+ if ($cursor) {
+ $validator = new Cursor();
+ if (!$validator->isValid($cursor)) {
+ throw new Exception(Exception::GENERAL_QUERY_INVALID, $validator->getDescription());
+ }
+
+ $documentId = $cursor->getValue();
+
+ $cursorDocument = Authorization::skip(fn () => $dbForProject->getDocument('database_' . $database->getSequence() . '_collection_' . $collection->getSequence(), $documentId));
+
+ if ($cursorDocument->isEmpty()) {
+ $type = ucfirst($this->getContext());
+ throw new Exception(Exception::GENERAL_CURSOR_NOT_FOUND, "$type '{$documentId}' for the 'cursor' value not found.");
+ }
+
+ $cursor->setValue($cursorDocument);
+ }
+ try {
+ $documents = $dbForProject->find('database_' . $database->getSequence() . '_collection_' . $collection->getSequence(), $queries);
+ $total = $dbForProject->count('database_' . $database->getSequence() . '_collection_' . $collection->getSequence(), $queries, APP_LIMIT_COUNT);
+ } catch (OrderException $e) {
+ $documents = $this->isCollectionsAPI() ? 'documents' : 'rows';
+ $attribute = $this->isCollectionsAPI() ? 'attribute' : 'column';
+ $message = "The order $attribute '{$e->getAttribute()}' had a null value. Cursor pagination requires all $documents order $attribute values are non-null.";
+ throw new Exception(Exception::DATABASE_QUERY_ORDER_NULL, $message);
+ } catch (QueryException $e) {
+ throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
+ }
+
+ $operations = 0;
+ $collectionsCache = [];
+ foreach ($documents as $document) {
+ $this->processDocument(
+ database: $database,
+ collection: $collection,
+ document: $document,
+ dbForProject: $dbForProject,
+ collectionsCache: $collectionsCache,
+ operations: $operations,
+ );
+ }
+
+ $queueForStatsUsage
+ ->addMetric(METRIC_DATABASES_OPERATIONS_READS, max($operations, 1))
+ ->addMetric(str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_OPERATIONS_READS), $operations);
+
+ $response->addHeader('X-Debug-Operations', $operations);
+
+ $select = \array_reduce($queries, function ($result, $query) {
+ return $result || ($query->getMethod() === Query::TYPE_SELECT);
+ }, false);
+
+ // Check if the SELECT query includes $databaseId and $collectionId
+ $hasDatabaseId = false;
+ $hasCollectionId = false;
+ if ($select) {
+ $hasDatabaseId = \array_reduce($queries, function ($result, $query) {
+ return $result || ($query->getMethod() === Query::TYPE_SELECT && \in_array('$databaseId', $query->getValues()));
+ }, false);
+ $hasCollectionId = \array_reduce($queries, function ($result, $query) {
+ return $result || ($query->getMethod() === Query::TYPE_SELECT && \in_array('$collectionId', $query->getValues()));
+ }, false);
+ }
+
+ if ($select) {
+ foreach ($documents as $document) {
+ if (!$hasDatabaseId) {
+ $document->removeAttribute('$databaseId');
+ }
+ if (!$hasCollectionId) {
+ $document->removeAttribute('$collectionId');
+ }
+ }
+ }
+
+ $response->dynamic(new Document([
+ 'total' => $total,
+ // rows or documents
+ $this->getSdkGroup() => $documents,
+ ]), $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Get.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Get.php
new file mode 100644
index 0000000000..e35a924657
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Get.php
@@ -0,0 +1,74 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId')
+ ->desc('Get collection')
+ ->groups(['api', 'database'])
+ ->label('scope', 'collections.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: 'databases',
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/get-collection.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->inject('response')
+ ->inject('dbForProject')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, UtopiaResponse $response, Database $dbForProject): void
+ {
+ $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
+
+ if ($database->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
+
+ if ($collection->isEmpty()) {
+ throw new Exception($this->getNotFoundException());
+ }
+
+ $response->dynamic($collection, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Indexes/Action.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Indexes/Action.php
new file mode 100644
index 0000000000..33c2977be5
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Indexes/Action.php
@@ -0,0 +1,156 @@
+context = COLUMN_INDEX;
+ }
+
+ return parent::setHttpPath($path);
+ }
+
+ /**
+ * Get the current API's parent context.
+ */
+ final protected function getParentContext(): string
+ {
+ return $this->getContext() === INDEX ? ATTRIBUTES : COLUMNS;
+ }
+
+ /**
+ * Get the current API context.
+ */
+ final protected function getContext(): string
+ {
+ return $this->context;
+ }
+
+ /**
+ * Determine if the current action is for the Collections API.
+ */
+ final protected function isCollectionsAPI(): bool
+ {
+ return $this->getParentContext() === ATTRIBUTES;
+ }
+
+ /**
+ * Get the SDK group name for the current action.
+ */
+ final protected function getSdkGroup(): string
+ {
+ return 'indexes';
+ }
+
+ /**
+ * Get the SDK namespace for the current action.
+ */
+ final protected function getSdkNamespace(): string
+ {
+ return $this->isCollectionsAPI() ? 'databases' : 'tables';
+ }
+
+ /**
+ * Get the exception to throw when the parent is unknown.
+ */
+ final protected function getParentUnknownException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::ATTRIBUTE_UNKNOWN
+ : Exception::COLUMN_UNKNOWN;
+ }
+
+ /**
+ * Get the appropriate grandparent level not found exception.
+ */
+ final protected function getGrandParentNotFoundException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::COLLECTION_NOT_FOUND
+ : Exception::TABLE_NOT_FOUND;
+ }
+
+ /**
+ * Get the appropriate not found exception.
+ */
+ final protected function getNotFoundException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::INDEX_NOT_FOUND
+ : Exception::COLUMN_INDEX_NOT_FOUND;
+ }
+
+ /**
+ * Get the exception to throw when the parent type is invalid.
+ */
+ final protected function getParentInvalidTypeException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::ATTRIBUTE_TYPE_INVALID
+ : Exception::COLUMN_TYPE_INVALID;
+ }
+
+ /**
+ * Get the exception to throw when the index type is invalid.
+ */
+ final protected function getInvalidTypeException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::INDEX_INVALID
+ : Exception::COLUMN_INDEX_INVALID;
+ }
+
+ /**
+ * Get the exception to throw when the resource already exists.
+ */
+ final protected function getDuplicateException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::INDEX_ALREADY_EXISTS
+ : Exception::COLUMN_INDEX_ALREADY_EXISTS;
+ }
+
+ /**
+ * Get the exception to throw when the resource limit is exceeded.
+ */
+ final protected function getLimitException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::INDEX_LIMIT_EXCEEDED
+ : Exception::COLUMN_INDEX_LIMIT_EXCEEDED;
+ }
+
+ /**
+ * Get the exception to throw when the parent attribute/column is not in `available` state.
+ */
+ final protected function getParentNotAvailableException(): string
+ {
+ return $this->isCollectionsAPI()
+ ? Exception::ATTRIBUTE_NOT_AVAILABLE
+ : Exception::COLUMN_NOT_AVAILABLE;
+ }
+
+ /**
+ * Get the correct collections context for Events queue.
+ */
+ final protected function getCollectionsEventsContext(): string
+ {
+ return $this->isCollectionsAPI() ? 'collection' : 'table';
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Indexes/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Indexes/Create.php
new file mode 100644
index 0000000000..9003fbb4a9
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Indexes/Create.php
@@ -0,0 +1,230 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/indexes')
+ ->desc('Create index')
+ ->groups(['api', 'database'])
+ ->label('event', 'databases.[databaseId].collections.[collectionId].indexes.[indexId].create')
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('audits.event', 'index.create')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/create-index.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_ACCEPTED,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
+ ->param('key', null, new Key(), 'Index Key.')
+ ->param('type', null, new WhiteList([Database::INDEX_KEY, Database::INDEX_FULLTEXT, Database::INDEX_UNIQUE]), 'Index type.')
+ ->param('attributes', null, new ArrayList(new Key(true), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Array of attributes to index. Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' attributes are allowed, each 32 characters long.')
+ ->param('orders', [], new ArrayList(new WhiteList(['ASC', 'DESC'], false, Database::VAR_STRING), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Array of index orders. Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' orders are allowed.', true)
+ ->param('lengths', [], new ArrayList(new Nullable(new Integer()), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Length of index. Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE, optional: true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $key, string $type, array $attributes, array $orders, array $lengths, UtopiaResponse $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents): void
+ {
+ $db = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
+
+ if ($db->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $collection = $dbForProject->getDocument('database_' . $db->getSequence(), $collectionId);
+
+ if ($collection->isEmpty()) {
+ // table or collection.
+ throw new Exception($this->getGrandParentNotFoundException());
+ }
+
+ $count = $dbForProject->count('indexes', [
+ Query::equal('collectionInternalId', [$collection->getSequence()]),
+ Query::equal('databaseInternalId', [$db->getSequence()])
+ ], 61);
+
+ $limit = $dbForProject->getLimitForIndexes();
+
+ if ($count >= $limit) {
+ throw new Exception($this->getLimitException(), 'Index limit exceeded');
+ }
+
+ // Convert Document array to array of attribute metadata
+ $oldAttributes = \array_map(fn ($a) => $a->getArrayCopy(), $collection->getAttribute('attributes'));
+
+ $oldAttributes[] = [
+ 'key' => '$id',
+ 'type' => Database::VAR_STRING,
+ 'status' => 'available',
+ 'required' => true,
+ 'array' => false,
+ 'default' => null,
+ 'size' => Database::LENGTH_KEY
+ ];
+
+ $oldAttributes[] = [
+ 'key' => '$createdAt',
+ 'type' => Database::VAR_DATETIME,
+ 'status' => 'available',
+ 'signed' => false,
+ 'required' => false,
+ 'array' => false,
+ 'default' => null,
+ 'size' => 0
+ ];
+
+ $oldAttributes[] = [
+ 'key' => '$updatedAt',
+ 'type' => Database::VAR_DATETIME,
+ 'status' => 'available',
+ 'signed' => false,
+ 'required' => false,
+ 'array' => false,
+ 'default' => null,
+ 'size' => 0
+ ];
+
+ $contextType = $this->getParentContext();
+ foreach ($attributes as $i => $attribute) {
+ // find attribute metadata in collection document
+ $attributeIndex = \array_search($attribute, array_column($oldAttributes, 'key'));
+
+ if ($attributeIndex === false) {
+ throw new Exception($this->getParentUnknownException(), "Unknown $contextType: " . $attribute . ". Verify the $contextType name or create the $contextType.");
+ }
+
+ $attributeStatus = $oldAttributes[$attributeIndex]['status'];
+ $attributeType = $oldAttributes[$attributeIndex]['type'];
+ $attributeArray = $oldAttributes[$attributeIndex]['array'] ?? false;
+
+ if ($attributeType === Database::VAR_RELATIONSHIP) {
+ throw new Exception($this->getParentInvalidTypeException(), "Cannot create an index for a relationship $contextType: " . $oldAttributes[$attributeIndex]['key']);
+ }
+
+ // ensure attribute is available
+ if ($attributeStatus !== 'available') {
+ $contextType = ucfirst($contextType);
+ throw new Exception($this->getParentNotAvailableException(), "$contextType not available: " . $oldAttributes[$attributeIndex]['key']);
+ }
+
+ $lengths[$i] ??= null;
+
+ if ($attributeArray === true) {
+ $lengths[$i] = Database::ARRAY_INDEX_LENGTH;
+ $orders[$i] = null;
+ }
+ }
+
+ $index = new Document([
+ '$id' => ID::custom($db->getSequence() . '_' . $collection->getSequence() . '_' . $key),
+ 'key' => $key,
+ 'status' => 'processing', // processing, available, failed, deleting, stuck
+ 'databaseInternalId' => $db->getSequence(),
+ 'databaseId' => $databaseId,
+ 'collectionInternalId' => $collection->getSequence(),
+ 'collectionId' => $collectionId,
+ 'type' => $type,
+ 'attributes' => $attributes,
+ 'lengths' => $lengths,
+ 'orders' => $orders,
+ ]);
+
+ $validator = new IndexValidator(
+ $collection->getAttribute('attributes'),
+ $dbForProject->getAdapter()->getMaxIndexLength(),
+ $dbForProject->getAdapter()->getInternalIndexesKeys(),
+ );
+
+ if (!$validator->isValid($index)) {
+ throw new Exception($this->getInvalidTypeException(), $validator->getDescription());
+ }
+
+ try {
+ $index = $dbForProject->createDocument('indexes', $index);
+ } catch (DuplicateException) {
+ throw new Exception($this->getDuplicateException());
+ }
+
+ $dbForProject->purgeCachedDocument('database_' . $db->getSequence(), $collectionId);
+
+ $queueForDatabase
+ ->setType(DATABASE_TYPE_CREATE_INDEX)
+ ->setDatabase($db);
+
+ if ($this->isCollectionsAPI()) {
+ $queueForDatabase
+ ->setCollection($collection)
+ ->setDocument($index);
+ } else {
+ $queueForDatabase
+ ->setTable($collection)
+ ->setRow($index);
+ }
+
+ $queueForEvents
+ ->setContext('database', $db)
+ ->setParam('databaseId', $databaseId)
+ ->setParam('indexId', $index->getId())
+ ->setParam('collectionId', $collection->getId())
+ ->setParam('tableId', $collection->getId())
+ ->setContext($this->getCollectionsEventsContext(), $collection);
+
+ $response
+ ->setStatusCode(SwooleResponse::STATUS_CODE_ACCEPTED)
+ ->dynamic($index, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Indexes/Delete.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Indexes/Delete.php
new file mode 100644
index 0000000000..701ab103ad
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Indexes/Delete.php
@@ -0,0 +1,123 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_DELETE)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/indexes/:key')
+ ->desc('Delete index')
+ ->groups(['api', 'database'])
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].collections.[collectionId].indexes.[indexId].update')
+ ->label('audits.event', 'index.delete')
+ ->label('audits.resource', 'database/{request.databaseId}/collection/{request.collectionId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/delete-index.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_NOCONTENT,
+ model: UtopiaResponse::MODEL_NONE,
+ )
+ ],
+ contentType: ContentType::NONE
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
+ ->param('key', '', new Key(), 'Index Key.')
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $key, UtopiaResponse $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents): void
+ {
+ $db = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
+
+ if ($db->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+ $collection = $dbForProject->getDocument('database_' . $db->getSequence(), $collectionId);
+
+ if ($collection->isEmpty()) {
+ // table or collection.
+ throw new Exception($this->getGrandParentNotFoundException());
+ }
+
+ $index = $dbForProject->getDocument('indexes', $db->getSequence() . '_' . $collection->getSequence() . '_' . $key);
+
+ if (empty($index->getId())) {
+ throw new Exception($this->getNotFoundException());
+ }
+
+ // Only update status if removing available index
+ if ($index->getAttribute('status') === 'available') {
+ $index = $dbForProject->updateDocument('indexes', $index->getId(), $index->setAttribute('status', 'deleting'));
+ }
+
+ $dbForProject->purgeCachedDocument('database_' . $db->getSequence(), $collectionId);
+
+ $queueForDatabase
+ ->setType(DATABASE_TYPE_DELETE_INDEX)
+ ->setDatabase($db);
+
+ if ($this->isCollectionsAPI()) {
+ $queueForDatabase
+ ->setCollection($collection)
+ ->setDocument($index);
+ } else {
+ $queueForDatabase
+ ->setTable($collection)
+ ->setRow($index);
+ }
+
+ $queueForEvents
+ ->setContext('database', $db)
+ ->setParam('databaseId', $databaseId)
+ ->setParam('indexId', $index->getId())
+ ->setParam('tableId', $collection->getId())
+ ->setParam('collectionId', $collection->getId())
+ ->setContext($this->getCollectionsEventsContext(), $collection)
+ ->setPayload($response->output($index, $this->getResponseModel()));
+
+ $response->noContent();
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Indexes/Get.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Indexes/Get.php
new file mode 100644
index 0000000000..c5b81fe231
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Indexes/Get.php
@@ -0,0 +1,81 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/indexes/:key')
+ ->desc('Get index')
+ ->groups(['api', 'database'])
+ ->label('scope', 'collections.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/get-index.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
+ ->param('key', null, new Key(), 'Index Key.')
+ ->inject('response')
+ ->inject('dbForProject')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $key, UtopiaResponse $response, Database $dbForProject): void
+ {
+ $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
+
+ if ($database->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+ $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
+
+ if ($collection->isEmpty()) {
+ // table or collection.
+ throw new Exception($this->getGrandParentNotFoundException());
+ }
+
+ $index = $collection->find('key', $key, 'indexes');
+ if (empty($index)) {
+ throw new Exception($this->getNotFoundException());
+ }
+
+ $response->dynamic($index, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Indexes/XList.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Indexes/XList.php
new file mode 100644
index 0000000000..36c52f711e
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Indexes/XList.php
@@ -0,0 +1,139 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/indexes')
+ ->desc('List indexes')
+ ->groups(['api', 'database'])
+ ->label('scope', 'collections.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/list-indexes.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
+ ->param('queries', [], new Indexes(), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long. You may filter on the following attributes: ' . implode(', ', Indexes::ALLOWED_ATTRIBUTES), true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, array $queries, UtopiaResponse $response, Database $dbForProject): void
+ {
+ /** @var Document $database */
+ $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
+
+ if ($database->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
+
+ if ($collection->isEmpty()) {
+ // table or collection.
+ throw new Exception($this->getGrandParentNotFoundException());
+ }
+
+ try {
+ $queries = Query::parseQueries($queries);
+ } catch (QueryException $e) {
+ throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
+ }
+
+ \array_push(
+ $queries,
+ Query::equal('databaseId', [$databaseId]),
+ Query::equal('collectionId', [$collectionId]),
+ );
+
+ /**
+ * Get cursor document if there was a cursor query, we use array_filter and reset for reference $cursor to $queries
+ */
+ $cursor = \array_filter($queries, function ($query) {
+ return \in_array($query->getMethod(), [Query::TYPE_CURSOR_AFTER, Query::TYPE_CURSOR_BEFORE]);
+ });
+ $cursor = reset($cursor);
+
+ if ($cursor) {
+ $validator = new Cursor();
+ if (!$validator->isValid($cursor)) {
+ throw new Exception(Exception::GENERAL_QUERY_INVALID, $validator->getDescription());
+ }
+
+ $indexId = $cursor->getValue();
+ $cursorDocument = Authorization::skip(fn () => $dbForProject->find('indexes', [
+ Query::equal('collectionInternalId', [$collection->getSequence()]),
+ Query::equal('databaseInternalId', [$database->getSequence()]),
+ Query::equal('key', [$indexId]),
+ Query::limit(1)
+ ]));
+
+ if (empty($cursorDocument) || $cursorDocument[0]->isEmpty()) {
+ throw new Exception(Exception::GENERAL_CURSOR_NOT_FOUND, "Index '{$indexId}' for the 'cursor' value not found.");
+ }
+
+ $cursor->setValue($cursorDocument[0]);
+ }
+
+ try {
+ $total = $dbForProject->count('indexes', $queries, APP_LIMIT_COUNT);
+ $indexes = $dbForProject->find('indexes', $queries);
+ } catch (OrderException $e) {
+ $documents = $this->isCollectionsAPI() ? 'documents' : 'rows';
+ $attribute = $this->isCollectionsAPI() ? 'attribute' : 'column';
+ $message = "The order $attribute '{$e->getAttribute()}' had a null value. Cursor pagination requires all $documents order $attribute values are non-null.";
+ throw new Exception(Exception::DATABASE_QUERY_ORDER_NULL, $message);
+ } catch (QueryException $e) {
+ throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
+ }
+
+ $response->dynamic(new Document([
+ 'total' => $total,
+ 'indexes' => $indexes,
+ ]), $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Logs/XList.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Logs/XList.php
new file mode 100644
index 0000000000..70bb14e9d8
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Logs/XList.php
@@ -0,0 +1,154 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/logs')
+ ->desc('List collection logs')
+ ->groups(['api', 'database'])
+ ->label('scope', 'collections.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: 'databases',
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/get-collection-logs.md',
+ auth: [AuthType::ADMIN],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('queries', [], new Queries([new Limit(), new Offset()]), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Only supported methods are limit and offset', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('locale')
+ ->inject('geodb')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, array $queries, UtopiaResponse $response, Database $dbForProject, Locale $locale, Reader $geodb): void
+ {
+ $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
+
+ if ($database->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $collectionDocument = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
+ $collection = $dbForProject->getCollection('database_' . $database->getSequence() . '_collection_' . $collectionDocument->getSequence());
+
+ if ($collection->isEmpty()) {
+ throw new Exception($this->getNotFoundException());
+ }
+
+ try {
+ $queries = Query::parseQueries($queries);
+ } catch (QueryException $e) {
+ throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
+ }
+
+ // Temp fix for logs
+ $queries[] = Query::or([
+ Query::greaterThan('$createdAt', DateTime::format(new \DateTime('2025-02-26T01:30+00:00'))),
+ Query::lessThan('$createdAt', DateTime::format(new \DateTime('2025-02-13T00:00+00:00'))),
+ ]);
+
+ $audit = new Audit($dbForProject);
+ $resource = 'database/' . $databaseId . '/' . $this->getContext() . '/' . $collectionId;
+ $logs = $audit->getLogsByResource($resource, $queries);
+
+ $output = [];
+
+ foreach ($logs as $i => &$log) {
+ $log['userAgent'] = (!empty($log['userAgent'])) ? $log['userAgent'] : 'UNKNOWN';
+
+ $detector = new Detector($log['userAgent']);
+ $detector->skipBotDetection(); // OPTIONAL: If called, bot detection will completely be skipped (bots will be detected as regular devices then)
+
+ $os = $detector->getOS();
+ $client = $detector->getClient();
+ $device = $detector->getDevice();
+
+ $output[$i] = new Document([
+ 'event' => $log['event'],
+ 'userId' => $log['data']['userId'],
+ 'userEmail' => $log['data']['userEmail'] ?? null,
+ 'userName' => $log['data']['userName'] ?? null,
+ 'mode' => $log['data']['mode'] ?? null,
+ 'ip' => $log['ip'],
+ 'time' => $log['time'],
+ 'osCode' => $os['osCode'],
+ 'osName' => $os['osName'],
+ 'osVersion' => $os['osVersion'],
+ 'clientType' => $client['clientType'],
+ 'clientCode' => $client['clientCode'],
+ 'clientName' => $client['clientName'],
+ 'clientVersion' => $client['clientVersion'],
+ 'clientEngine' => $client['clientEngine'],
+ 'clientEngineVersion' => $client['clientEngineVersion'],
+ 'deviceName' => $device['deviceName'],
+ 'deviceBrand' => $device['deviceBrand'],
+ 'deviceModel' => $device['deviceModel']
+ ]);
+
+ $record = $geodb->get($log['ip']);
+
+ if ($record) {
+ $output[$i]['countryCode'] = $locale->getText('countries.' . strtolower($record['country']['iso_code']), false) ? \strtolower($record['country']['iso_code']) : '--';
+ $output[$i]['countryName'] = $locale->getText('countries.' . strtolower($record['country']['iso_code']), $locale->getText('locale.country.unknown'));
+ } else {
+ $output[$i]['countryCode'] = '--';
+ $output[$i]['countryName'] = $locale->getText('locale.country.unknown');
+ }
+ }
+
+ $response->dynamic(new Document([
+ 'logs' => $output,
+ 'total' => $audit->countLogsByResource($resource, $queries),
+ ]), $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Update.php
new file mode 100644
index 0000000000..fd3b1e8bda
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Update.php
@@ -0,0 +1,110 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PUT)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId')
+ ->desc('Update collection')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'collections.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].collections.[collectionId].update')
+ ->label('audits.event', 'collection.update')
+ ->label('audits.resource', 'database/{request.databaseId}/collections/{request.collectionId}')
+ ->label('sdk', new Method(
+ namespace: 'databases',
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/update-collection.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->param('name', null, new Text(128), 'Collection name. Max length: 128 chars.')
+ ->param('permissions', null, new Permissions(APP_LIMIT_ARRAY_PARAMS_SIZE), 'An array of permission strings. By default, the current permissions are inherited. [Learn more about permissions](https://appwrite.io/docs/permissions).', true)
+ ->param('documentSecurity', false, new Boolean(true), 'Enables configuring permissions for individual documents. A user needs one of document or collection level permissions to access a document. [Learn more about permissions](https://appwrite.io/docs/permissions).', true)
+ ->param('enabled', true, new Boolean(), 'Is collection enabled? When set to \'disabled\', users cannot access the collection but Server SDKs with and API key can still read and write to the collection. No data is lost when this is toggled.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $collectionId, string $name, ?array $permissions, bool $documentSecurity, bool $enabled, UtopiaResponse $response, Database $dbForProject, Event $queueForEvents): void
+ {
+ $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
+ if ($database->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $collection = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
+ if ($collection->isEmpty()) {
+ throw new Exception($this->getNotFoundException());
+ }
+
+ $permissions ??= $collection->getPermissions() ?? [];
+
+ // Map aggregate permissions into the multiple permissions they represent.
+ $permissions = Permission::aggregate($permissions);
+
+ $enabled ??= $collection->getAttribute('enabled', true);
+
+ $collection = $dbForProject->updateDocument(
+ 'database_' . $database->getSequence(),
+ $collectionId,
+ $collection
+ ->setAttribute('name', $name)
+ ->setAttribute('$permissions', $permissions)
+ ->setAttribute('documentSecurity', $documentSecurity)
+ ->setAttribute('enabled', $enabled)
+ ->setAttribute('search', \implode(' ', [$collectionId, $name]))
+ );
+
+ $dbForProject->updateCollection('database_' . $database->getSequence() . '_collection_' . $collection->getSequence(), $permissions, $documentSecurity);
+
+ $queueForEvents
+ ->setContext('database', $database)
+ ->setParam('databaseId', $databaseId)
+ ->setParam($this->getEventsParamKey(), $collection->getId());
+
+ $response->dynamic($collection, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Usage/Get.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Usage/Get.php
new file mode 100644
index 0000000000..e5335d6abf
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/Usage/Get.php
@@ -0,0 +1,136 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/:databaseId/collections/:collectionId/usage')
+ ->desc('Get collection usage stats')
+ ->groups(['api', 'database', 'usage'])
+ ->label('scope', 'collections.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: 'databases',
+ group: null,
+ name: self::getName(),
+ description: '/docs/references/databases/get-collection-usage.md',
+ auth: [AuthType::ADMIN],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel()
+ )
+ ],
+ contentType: ContentType::JSON,
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('range', '30d', new WhiteList(['24h', '30d', '90d'], true), 'Date range.', true)
+ ->param('collectionId', '', new UID(), 'Collection ID.')
+ ->inject('response')
+ ->inject('dbForProject')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $range, string $collectionId, UtopiaResponse $response, Database $dbForProject): void
+ {
+ $database = $dbForProject->getDocument('databases', $databaseId);
+ $collectionDocument = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionId);
+ $collection = $dbForProject->getCollection('database_' . $database->getSequence() . '_collection_' . $collectionDocument->getSequence());
+
+ if ($collection->isEmpty()) {
+ throw new Exception($this->getNotFoundException());
+ }
+
+ $periods = Config::getParam('usage', []);
+ $stats = $usage = [];
+ $days = $periods[$range];
+ $metrics = [
+ str_replace(['{databaseInternalId}', '{collectionInternalId}'], [$database->getSequence(), $collectionDocument->getSequence()], METRIC_DATABASE_ID_COLLECTION_ID_DOCUMENTS),
+ ];
+
+ Authorization::skip(function () use ($dbForProject, $days, $metrics, &$stats) {
+ foreach ($metrics as $metric) {
+ $result = $dbForProject->findOne('stats', [
+ Query::equal('metric', [$metric]),
+ Query::equal('period', ['inf'])
+ ]);
+
+ $stats[$metric]['total'] = $result['value'] ?? 0;
+ $limit = $days['limit'];
+ $period = $days['period'];
+ $results = $dbForProject->find('stats', [
+ Query::equal('metric', [$metric]),
+ Query::equal('period', [$period]),
+ Query::limit($limit),
+ Query::orderDesc('time'),
+ ]);
+ $stats[$metric]['data'] = [];
+ foreach ($results as $result) {
+ $stats[$metric]['data'][$result->getAttribute('time')] = [
+ 'value' => $result->getAttribute('value'),
+ ];
+ }
+ }
+ });
+
+ $format = match ($days['period']) {
+ '1h' => 'Y-m-d\TH:00:00.000P',
+ '1d' => 'Y-m-d\T00:00:00.000P',
+ };
+
+ foreach ($metrics as $metric) {
+ $usage[$metric]['total'] = $stats[$metric]['total'];
+ $usage[$metric]['data'] = [];
+ $leap = time() - ($days['limit'] * $days['factor']);
+ while ($leap < time()) {
+ $leap += $days['factor'];
+ $formatDate = date($format, $leap);
+ $usage[$metric]['data'][] = [
+ 'value' => $stats[$metric]['data'][$formatDate]['value'] ?? 0,
+ 'date' => $formatDate,
+ ];
+ }
+ }
+
+ $prefix = $this->isCollectionsAPI() ? 'documents' : 'rows';
+
+ // prefix, prefixTotal
+ $usageDocument = new Document([
+ 'range' => $range,
+ $prefix => $usage[$metrics[0]]['data'],
+ $prefix . 'Total' => $usage[$metrics[0]]['total'],
+ ]);
+
+ $response->dynamic($usageDocument, $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/XList.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/XList.php
new file mode 100644
index 0000000000..3a9868dec2
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Collections/XList.php
@@ -0,0 +1,122 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/:databaseId/collections')
+ ->desc('List collections')
+ ->groups(['api', 'database'])
+ ->label('scope', 'collections.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: 'databases',
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/list-collections.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('queries', [], new Collections(), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long. You may filter on the following attributes: ' . implode(', ', Collections::ALLOWED_ATTRIBUTES), true)
+ ->param('search', '', new Text(256), 'Search term to filter your list results. Max length: 256 chars.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, array $queries, string $search, UtopiaResponse $response, Database $dbForProject): void
+ {
+ $database = Authorization::skip(fn () => $dbForProject->getDocument('databases', $databaseId));
+
+ if ($database->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ try {
+ $queries = Query::parseQueries($queries);
+ } catch (QueryException $e) {
+ throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
+ }
+
+ if (!empty($search)) {
+ $queries[] = Query::search('search', $search);
+ }
+
+ /**
+ * Get cursor document if there was a cursor query, we use array_filter and reset for reference $cursor to $queries
+ */
+ $cursor = \array_filter($queries, function ($query) {
+ return \in_array($query->getMethod(), [Query::TYPE_CURSOR_AFTER, Query::TYPE_CURSOR_BEFORE]);
+ });
+ $cursor = reset($cursor);
+
+ if ($cursor) {
+ $validator = new Cursor();
+ if (!$validator->isValid($cursor)) {
+ throw new Exception(Exception::GENERAL_QUERY_INVALID, $validator->getDescription());
+ }
+
+ $collectionIdId = $cursor->getValue();
+ $cursorDocument = $dbForProject->getDocument('database_' . $database->getSequence(), $collectionIdId);
+
+ if ($cursorDocument->isEmpty()) {
+ throw new Exception(Exception::GENERAL_CURSOR_NOT_FOUND, ucfirst($this->getContext()) . " '$collectionIdId' for the 'cursor' value not found.");
+ }
+
+ $cursor->setValue($cursorDocument);
+ }
+
+ try {
+ $collections = $dbForProject->find('database_' . $database->getSequence(), $queries);
+ $total = $dbForProject->count('database_' . $database->getSequence(), $queries, APP_LIMIT_COUNT);
+ } catch (OrderException) {
+ throw new Exception(Exception::DATABASE_QUERY_ORDER_NULL);
+ } catch (QueryException) {
+ throw new Exception(Exception::GENERAL_QUERY_INVALID);
+ }
+
+ $response->dynamic(new Document([
+ 'total' => $total,
+ $this->getSdkGroup() => $collections,
+ ]), $this->getResponseModel());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Create.php
new file mode 100644
index 0000000000..38374402fb
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Create.php
@@ -0,0 +1,122 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases')
+ ->desc('Create database')
+ ->groups(['api', 'database'])
+ ->label('event', 'databases.[databaseId].create')
+ ->label('scope', 'databases.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('audits.event', 'database.create')
+ ->label('audits.resource', 'database/{response.$id}')
+ ->label('sdk', new Method(
+ namespace: 'databases',
+ group: 'databases',
+ name: 'create',
+ description: '/docs/references/databases/create.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_CREATED,
+ model: UtopiaResponse::MODEL_DATABASE,
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new CustomId(), 'Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can\'t start with a special char. Max length is 36 chars.')
+ ->param('name', '', new Text(128), 'Database name. Max length: 128 chars.')
+ ->param('enabled', true, new Boolean(), 'Is the database enabled? When set to \'disabled\', users cannot access the database but Server SDKs with an API key can still read and write to the database. No data is lost when this is toggled.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $name, bool $enabled, UtopiaResponse $response, Database $dbForProject, Event $queueForEvents): void
+ {
+ $databaseId = $databaseId == 'unique()' ? ID::unique() : $databaseId;
+
+ try {
+ $dbForProject->createDocument('databases', new Document([
+ '$id' => $databaseId,
+ 'name' => $name,
+ 'enabled' => $enabled,
+ 'search' => implode(' ', [$databaseId, $name]),
+ ]));
+ } catch (DuplicateException) {
+ throw new Exception(Exception::DATABASE_ALREADY_EXISTS);
+ } catch (StructureException $e) {
+ // TODO: @Jake, how do we handle this document/row?
+ // there's no context awareness at this level on what the api is.
+ throw new Exception(Exception::DOCUMENT_INVALID_STRUCTURE, $e->getMessage());
+ }
+
+ $database = $dbForProject->getDocument('databases', $databaseId);
+
+ $collections = (Config::getParam('collections', [])['databases'] ?? [])['collections'] ?? [];
+ if (empty($collections)) {
+ throw new Exception(Exception::GENERAL_SERVER_ERROR, 'The "collections" collection is not configured.');
+ }
+
+ $attributes = [];
+ foreach ($collections['attributes'] as $attribute) {
+ $attributes[] = new Document($attribute);
+ }
+
+ $indexes = [];
+ foreach ($collections['indexes'] as $index) {
+ $indexes[] = new Document($index);
+ }
+
+ try {
+ $dbForProject->createCollection('database_' . $database->getSequence(), $attributes, $indexes);
+ } catch (DuplicateException) {
+ throw new Exception(Exception::DATABASE_ALREADY_EXISTS);
+ } catch (IndexException) {
+ throw new Exception(Exception::INDEX_INVALID);
+ } catch (LimitException) {
+ // TODO: @Jake, how do we handle this collection/table?
+ // there's no context awareness at this level on what the api is.
+ throw new Exception(Exception::COLLECTION_LIMIT_EXCEEDED);
+ }
+
+ $queueForEvents->setParam('databaseId', $database->getId());
+
+ $response
+ ->setStatusCode(SwooleResponse::STATUS_CODE_CREATED)
+ ->dynamic($database, UtopiaResponse::MODEL_DATABASE);
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Delete.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Delete.php
new file mode 100644
index 0000000000..56cf1a4296
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Delete.php
@@ -0,0 +1,85 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_DELETE)
+ ->setHttpPath('/v1/databases/:databaseId')
+ ->desc('Delete database')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'databases.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].delete')
+ ->label('audits.event', 'database.delete')
+ ->label('audits.resource', 'database/{request.databaseId}')
+ ->label('sdk', new Method(
+ namespace: 'databases',
+ group: 'databases',
+ name: 'delete',
+ description: '/docs/references/databases/delete.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_NOCONTENT,
+ model: UtopiaResponse::MODEL_NONE,
+ )
+ ],
+ contentType: ContentType::NONE
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->inject('queueForStatsUsage')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, UtopiaResponse $response, Database $dbForProject, EventDatabase $queueForDatabase, Event $queueForEvents): void
+ {
+ $database = $dbForProject->getDocument('databases', $databaseId);
+
+ if ($database->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ if (!$dbForProject->deleteDocument('databases', $databaseId)) {
+ throw new Exception(Exception::GENERAL_SERVER_ERROR, 'Failed to remove collection from DB');
+ }
+
+ $dbForProject->purgeCachedDocument('databases', $database->getId());
+ $dbForProject->purgeCachedCollection('databases_' . $database->getSequence());
+
+ $queueForDatabase
+ ->setType(DATABASE_TYPE_DELETE_DATABASE)
+ ->setDatabase($database);
+
+ $queueForEvents
+ ->setParam('databaseId', $database->getId())
+ ->setPayload($response->output($database, UtopiaResponse::MODEL_DATABASE));
+
+ $response->noContent();
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Get.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Get.php
new file mode 100644
index 0000000000..f478dc7917
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Get.php
@@ -0,0 +1,62 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/:databaseId')
+ ->desc('Get database')
+ ->groups(['api', 'database'])
+ ->label('scope', 'databases.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: 'databases',
+ group: 'databases',
+ name: 'get',
+ description: '/docs/references/databases/get.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: UtopiaResponse::MODEL_DATABASE,
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->inject('response')
+ ->inject('dbForProject')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, UtopiaResponse $response, Database $dbForProject): void
+ {
+ $database = $dbForProject->getDocument('databases', $databaseId);
+
+ if ($database->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $response->dynamic($database, UtopiaResponse::MODEL_DATABASE);
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Logs/XList.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Logs/XList.php
new file mode 100644
index 0000000000..52f2ad93b6
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Logs/XList.php
@@ -0,0 +1,140 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/:databaseId/logs')
+ ->desc('List database logs')
+ ->groups(['api', 'database'])
+ ->label('scope', 'databases.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: 'databases',
+ group: 'logs',
+ name: 'listLogs',
+ description: '/docs/references/databases/get-logs.md',
+ auth: [AuthType::ADMIN],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: UtopiaResponse::MODEL_LOG_LIST,
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('queries', [], new Queries([new Limit(), new Offset()]), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Only supported methods are limit and offset', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('locale')
+ ->inject('geodb')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, array $queries, UtopiaResponse $response, Database $dbForProject, Locale $locale, Reader $geodb): void
+ {
+ $database = $dbForProject->getDocument('databases', $databaseId);
+
+ if ($database->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ try {
+ $queries = Query::parseQueries($queries);
+ } catch (QueryException $e) {
+ throw new Exception(Exception::GENERAL_QUERY_INVALID, $e->getMessage());
+ }
+
+ // Temp fix for logs
+ $queries[] = Query::or([
+ Query::greaterThan('$createdAt', DateTime::format(new \DateTime('2025-02-26T01:30+00:00'))),
+ Query::lessThan('$createdAt', DateTime::format(new \DateTime('2025-02-13T00:00+00:00'))),
+ ]);
+
+ $audit = new Audit($dbForProject);
+ $resource = 'database/' . $databaseId;
+ $logs = $audit->getLogsByResource($resource, $queries);
+
+ $output = [];
+
+ foreach ($logs as $i => &$log) {
+ $log['userAgent'] = $log['userAgent'] ?: 'UNKNOWN';
+ $detector = new Detector($log['userAgent']);
+ $detector->skipBotDetection();
+
+ $os = $detector->getOS();
+ $client = $detector->getClient();
+ $device = $detector->getDevice();
+
+ $output[$i] = new Document([
+ 'event' => $log['event'],
+ 'userId' => ID::custom($log['data']['userId']),
+ 'userEmail' => $log['data']['userEmail'] ?? null,
+ 'userName' => $log['data']['userName'] ?? null,
+ 'mode' => $log['data']['mode'] ?? null,
+ 'ip' => $log['ip'],
+ 'time' => $log['time'],
+ 'osCode' => $os['osCode'],
+ 'osName' => $os['osName'],
+ 'osVersion' => $os['osVersion'],
+ 'clientType' => $client['clientType'],
+ 'clientCode' => $client['clientCode'],
+ 'clientName' => $client['clientName'],
+ 'clientVersion' => $client['clientVersion'],
+ 'clientEngine' => $client['clientEngine'],
+ 'clientEngineVersion' => $client['clientEngineVersion'],
+ 'deviceName' => $device['deviceName'],
+ 'deviceBrand' => $device['deviceBrand'],
+ 'deviceModel' => $device['deviceModel'],
+ ]);
+
+ $record = $geodb->get($log['ip']);
+ if ($record) {
+ $countryCode = strtolower($record['country']['iso_code']);
+ $output[$i]['countryCode'] = $locale->getText("countries.{$countryCode}", false) ? $countryCode : '--';
+ $output[$i]['countryName'] = $locale->getText("countries.{$countryCode}", $locale->getText('locale.country.unknown'));
+ } else {
+ $output[$i]['countryCode'] = '--';
+ $output[$i]['countryName'] = $locale->getText('locale.country.unknown');
+ }
+ }
+
+ $response->dynamic(new Document([
+ 'total' => $audit->countLogsByResource($resource, $queries),
+ 'logs' => $output,
+ ]), UtopiaResponse::MODEL_LOG_LIST);
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Boolean/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Boolean/Create.php
new file mode 100644
index 0000000000..30972e8458
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Boolean/Create.php
@@ -0,0 +1,64 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/columns/boolean')
+ ->desc('Create boolean column')
+ ->groups(['api', 'database', 'schema'])
+ ->label('event', 'databases.[databaseId].tables.[tableId].columns.[columnId].create')
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('audits.event', 'column.create')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/create-boolean-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_ACCEPTED,
+ model: $this->getResponseModel(),
+ )
+ ]
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID. You can create a new table using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
+ ->param('key', '', new Key(), 'Column Key.')
+ ->param('required', null, new Boolean(), 'Is column required?')
+ ->param('default', null, new Boolean(), 'Default value for column when not provided. Cannot be set when column is required.', true)
+ ->param('array', false, new Boolean(), 'Is column an array?', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Boolean/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Boolean/Update.php
new file mode 100644
index 0000000000..82e7d9526d
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Boolean/Update.php
@@ -0,0 +1,66 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/columns/boolean/:key')
+ ->desc('Update boolean column')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].tables.[tableId].columns.[columnId].update')
+ ->label('audits.event', 'column.update')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/update-boolean-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID. You can create a new table using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
+ ->param('key', '', new Key(), 'Column Key.')
+ ->param('required', null, new Boolean(), 'Is column required?')
+ ->param('default', null, new Nullable(new Boolean()), 'Default value for column when not provided. Cannot be set when column is required.')
+ ->param('newKey', null, new Key(), 'New Column Key.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Datetime/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Datetime/Create.php
new file mode 100644
index 0000000000..44e9cf9cd3
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Datetime/Create.php
@@ -0,0 +1,66 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/columns/datetime')
+ ->desc('Create datetime column')
+ ->groups(['api', 'database'])
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].tables.[tableId].columns.[columnId].create')
+ ->label('audits.event', 'column.create')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/create-datetime-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_ACCEPTED,
+ model: $this->getResponseModel(),
+ )
+ ]
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('key', '', new Key(), 'Column Key.')
+ ->param('required', null, new Boolean(), 'Is column required?')
+ ->param('default', null, fn (Database $dbForProject) => new DatetimeValidator($dbForProject->getAdapter()->getMinDateTime(), $dbForProject->getAdapter()->getMaxDateTime()), 'Default value for the column in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. Cannot be set when column is required.', true, ['dbForProject'])
+ ->param('array', false, new Boolean(), 'Is column an array?', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Datetime/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Datetime/Update.php
new file mode 100644
index 0000000000..27f5f3e82b
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Datetime/Update.php
@@ -0,0 +1,68 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/columns/datetime/:key')
+ ->desc('Update dateTime column')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].tables.[tableId].columns.[columnId].update')
+ ->label('audits.event', 'column.update')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/update-datetime-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('key', '', new Key(), 'Column Key.')
+ ->param('required', null, new Boolean(), 'Is column required?')
+ ->param('default', null, fn (Database $dbForProject) => new Nullable(new DatetimeValidator($dbForProject->getAdapter()->getMinDateTime(), $dbForProject->getAdapter()->getMaxDateTime())), 'Default value for column when not provided. Cannot be set when column is required.', injections: ['dbForProject'])
+ ->param('newKey', null, new Key(), 'New Column Key.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Delete.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Delete.php
new file mode 100644
index 0000000000..ce3e66a85f
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Delete.php
@@ -0,0 +1,63 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_DELETE)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/columns/:key')
+ ->desc('Delete column')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].tables.[tableId].columns.[columnId].update')
+ ->label('audits.event', 'column.delete')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/delete-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_NOCONTENT,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::NONE
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('key', '', new Key(), 'Column Key.')
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Email/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Email/Create.php
new file mode 100644
index 0000000000..c497b9d78c
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Email/Create.php
@@ -0,0 +1,65 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/columns/email')
+ ->desc('Create email column')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].tables.[tableId].columns.[columnId].create')
+ ->label('audits.event', 'column.create')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/create-email-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_ACCEPTED,
+ model: $this->getResponseModel(),
+ )
+ ]
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('key', '', new Key(), 'Column Key.')
+ ->param('required', null, new Boolean(), 'Is column required?')
+ ->param('default', null, new Email(), 'Default value for column when not provided. Cannot be set when column is required.', true)
+ ->param('array', false, new Boolean(), 'Is column an array?', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Email/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Email/Update.php
new file mode 100644
index 0000000000..267d5b80e7
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Email/Update.php
@@ -0,0 +1,67 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/columns/email/:key')
+ ->desc('Update email column')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].tables.[tableId].columns.[columnId].update')
+ ->label('audits.event', 'column.update')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/update-email-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('key', '', new Key(), 'Column Key.')
+ ->param('required', null, new Boolean(), 'Is column required?')
+ ->param('default', null, new Nullable(new Email()), 'Default value for column when not provided. Cannot be set when column is required.')
+ ->param('newKey', null, new Key(), 'New Column Key.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Enum/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Enum/Create.php
new file mode 100644
index 0000000000..38b7ac231a
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Enum/Create.php
@@ -0,0 +1,68 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/columns/enum')
+ ->desc('Create enum column')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].tables.[tableId].columns.[columnId].create')
+ ->label('audits.event', 'column.create')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/create-attribute-enum.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_ACCEPTED,
+ model: $this->getResponseModel(),
+ )
+ ]
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('key', '', new Key(), 'Column Key.')
+ ->param('elements', [], new ArrayList(new Text(Database::LENGTH_KEY), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Array of enum values.')
+ ->param('required', null, new Boolean(), 'Is column required?')
+ ->param('default', null, new Text(0), 'Default value for column when not provided. Cannot be set when column is required.', true)
+ ->param('array', false, new Boolean(), 'Is column an array?', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Enum/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Enum/Update.php
new file mode 100644
index 0000000000..97785b1121
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Enum/Update.php
@@ -0,0 +1,70 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/columns/enum/:key')
+ ->desc('Update enum column')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].tables.[tableId].columns.[columnId].update')
+ ->label('audits.event', 'column.update')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/update-enum-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('key', '', new Key(), 'Column Key.')
+ ->param('elements', null, new ArrayList(new Text(Database::LENGTH_KEY), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Updated list of enum values.')
+ ->param('required', null, new Boolean(), 'Is column required?')
+ ->param('default', null, new Nullable(new Text(0)), 'Default value for column when not provided. Cannot be set when column is required.')
+ ->param('newKey', null, new Key(), 'New Column Key.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Float/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Float/Create.php
new file mode 100644
index 0000000000..4a96165b32
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Float/Create.php
@@ -0,0 +1,67 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/columns/float')
+ ->desc('Create float column')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].tables.[tableId].columns.[columnId].create')
+ ->label('audits.event', 'column.create')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/create-float-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_ACCEPTED,
+ model: $this->getResponseModel(),
+ )
+ ]
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('key', '', new Key(), 'Column Key.')
+ ->param('required', null, new Boolean(), 'Is column required?')
+ ->param('min', null, new FloatValidator(), 'Minimum value', true)
+ ->param('max', null, new FloatValidator(), 'Maximum value', true)
+ ->param('default', null, new FloatValidator(), 'Default value. Cannot be set when required.', true)
+ ->param('array', false, new Boolean(), 'Is column an array?', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Float/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Float/Update.php
new file mode 100644
index 0000000000..d570ce4857
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Float/Update.php
@@ -0,0 +1,69 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/columns/float/:key')
+ ->desc('Update float column')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].tables.[tableId].columns.[columnId].update')
+ ->label('audits.event', 'column.update')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/update-float-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('key', '', new Key(), 'Column Key.')
+ ->param('required', null, new Boolean(), 'Is column required?')
+ ->param('min', null, new FloatValidator(), 'Minimum value', true)
+ ->param('max', null, new FloatValidator(), 'Maximum value', true)
+ ->param('default', null, new Nullable(new FloatValidator()), 'Default value. Cannot be set when required.')
+ ->param('newKey', null, new Key(), 'New Column Key.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Get.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Get.php
new file mode 100644
index 0000000000..85ac43b63d
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Get.php
@@ -0,0 +1,66 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/columns/:key')
+ ->desc('Get column')
+ ->groups(['api', 'database'])
+ ->label('scope', 'tables.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/get-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel()
+ )
+ ]
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('key', '', new Key(), 'Column Key.')
+ ->inject('response')
+ ->inject('dbForProject')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/IP/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/IP/Create.php
new file mode 100644
index 0000000000..874c0f2132
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/IP/Create.php
@@ -0,0 +1,65 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/columns/ip')
+ ->desc('Create IP address column')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].tables.[tableId].columns.[columnId].create')
+ ->label('audits.event', 'column.create')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/create-ip-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_ACCEPTED,
+ model: $this->getResponseModel(),
+ )
+ ]
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('key', '', new Key(), 'Column Key.')
+ ->param('required', null, new Boolean(), 'Is column required?')
+ ->param('default', null, new IP(), 'Default value. Cannot be set when column is required.', true)
+ ->param('array', false, new Boolean(), 'Is column an array?', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/IP/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/IP/Update.php
new file mode 100644
index 0000000000..73a73bccac
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/IP/Update.php
@@ -0,0 +1,67 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/columns/ip/:key')
+ ->desc('Update IP address column')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].tables.[tableId].columns.[columnId].update')
+ ->label('audits.event', 'column.update')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/update-ip-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('key', '', new Key(), 'Column Key.')
+ ->param('required', null, new Boolean(), 'Is column required?')
+ ->param('default', null, new Nullable(new IP()), 'Default value. Cannot be set when column is required.')
+ ->param('newKey', null, new Key(), 'New Column Key.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Integer/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Integer/Create.php
new file mode 100644
index 0000000000..11a36c1e3c
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Integer/Create.php
@@ -0,0 +1,67 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/columns/integer')
+ ->desc('Create integer column')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].tables.[tableId].columns.[columnId].create')
+ ->label('audits.event', 'column.create')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/create-integer-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_ACCEPTED,
+ model: $this->getResponseModel(),
+ )
+ ]
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('key', '', new Key(), 'Column Key.')
+ ->param('required', null, new Boolean(), 'Is column required?')
+ ->param('min', null, new Integer(), 'Minimum value', true)
+ ->param('max', null, new Integer(), 'Maximum value', true)
+ ->param('default', null, new Integer(), 'Default value. Cannot be set when column is required.', true)
+ ->param('array', false, new Boolean(), 'Is column an array?', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Integer/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Integer/Update.php
new file mode 100644
index 0000000000..292eb3de7b
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Integer/Update.php
@@ -0,0 +1,69 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/columns/integer/:key')
+ ->desc('Update integer column')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].tables.[tableId].columns.[columnId].update')
+ ->label('audits.event', 'column.update')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/update-integer-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('key', '', new Key(), 'Column Key.')
+ ->param('required', null, new Boolean(), 'Is column required?')
+ ->param('min', null, new Integer(), 'Minimum value', true)
+ ->param('max', null, new Integer(), 'Maximum value', true)
+ ->param('default', null, new Nullable(new Integer()), 'Default value. Cannot be set when column is required.')
+ ->param('newKey', null, new Key(), 'New Column Key.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Relationship/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Relationship/Create.php
new file mode 100644
index 0000000000..583f8bb16c
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Relationship/Create.php
@@ -0,0 +1,77 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/columns/relationship')
+ ->desc('Create relationship column')
+ ->groups(['api', 'database'])
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].tables.[tableId].columns.[columnId].create')
+ ->label('audits.event', 'column.create')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/create-relationship-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_ACCEPTED,
+ model: $this->getResponseModel()
+ )
+ ]
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('relatedTableId', '', new UID(), 'Related Table ID.')
+ ->param('type', '', new WhiteList([
+ Database::RELATION_ONE_TO_ONE,
+ Database::RELATION_MANY_TO_ONE,
+ Database::RELATION_MANY_TO_MANY,
+ Database::RELATION_ONE_TO_MANY
+ ], true), 'Relation type')
+ ->param('twoWay', false, new Boolean(), 'Is Two Way?', true)
+ ->param('key', null, new Key(), 'Column Key.', true)
+ ->param('twoWayKey', null, new Key(), 'Two Way Column Key.', true)
+ ->param('onDelete', Database::RELATION_MUTATE_RESTRICT, new WhiteList([
+ Database::RELATION_MUTATE_CASCADE,
+ Database::RELATION_MUTATE_RESTRICT,
+ Database::RELATION_MUTATE_SET_NULL
+ ], true), 'Constraints option', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Relationship/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Relationship/Update.php
new file mode 100644
index 0000000000..d17cf9def2
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/Relationship/Update.php
@@ -0,0 +1,69 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/columns/:key/relationship')
+ ->desc('Update relationship column')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].tables.[tableId].columns.[columnId].update')
+ ->label('audits.event', 'column.update')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/update-relationship-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel()
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('key', '', new Key(), 'Column Key.')
+ ->param('onDelete', null, new WhiteList([
+ Database::RELATION_MUTATE_CASCADE,
+ Database::RELATION_MUTATE_RESTRICT,
+ Database::RELATION_MUTATE_SET_NULL
+ ], true), 'Constraints option', true)
+ ->param('newKey', null, new Key(), 'New Column Key.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/String/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/String/Create.php
new file mode 100644
index 0000000000..9d86fc8c8e
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/String/Create.php
@@ -0,0 +1,70 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/columns/string')
+ ->desc('Create string column')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].tables.[tableId].columns.[columnId].create')
+ ->label('audits.event', 'column.create')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/create-string-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_ACCEPTED,
+ model: $this->getResponseModel()
+ )
+ ]
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID. You can create a new table using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
+ ->param('key', '', new Key(), 'Column Key.')
+ ->param('size', null, new Range(1, APP_DATABASE_ATTRIBUTE_STRING_MAX_LENGTH, Validator::TYPE_INTEGER), 'Attribute size for text attributes, in number of characters.')
+ ->param('required', null, new Boolean(), 'Is column required?')
+ ->param('default', null, new Text(0, 0), 'Default value for column when not provided. Cannot be set when column is required.', true)
+ ->param('array', false, new Boolean(), 'Is column an array?', true)
+ ->param('encrypt', false, new Boolean(), 'Toggle encryption for the column. Encryption enhances security by not storing any plain text values in the database. However, encrypted columns cannot be queried.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->inject('plan')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/String/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/String/Update.php
new file mode 100644
index 0000000000..8106ccf626
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/String/Update.php
@@ -0,0 +1,70 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/columns/string/:key')
+ ->desc('Update string column')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].tables.[tableId].columns.[columnId].update')
+ ->label('audits.event', 'column.update')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/update-string-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID. You can create a new table using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
+ ->param('key', '', new Key(), 'Column Key.')
+ ->param('required', null, new Boolean(), 'Is column required?')
+ ->param('default', null, new Nullable(new Text(0, 0)), 'Default value for column when not provided. Cannot be set when column is required.')
+ ->param('size', null, new Range(1, APP_DATABASE_ATTRIBUTE_STRING_MAX_LENGTH, Validator::TYPE_INTEGER), 'Maximum size of the string column.', true)
+ ->param('newKey', null, new Key(), 'New Column Key.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/URL/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/URL/Create.php
new file mode 100644
index 0000000000..340b120c5c
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/URL/Create.php
@@ -0,0 +1,65 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/columns/url')
+ ->desc('Create URL column')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].tables.[tableId].columns.[columnId].create')
+ ->label('audits.event', 'column.create')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/create-url-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_ACCEPTED,
+ model: $this->getResponseModel(),
+ )
+ ]
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('key', '', new Key(), 'Column Key.')
+ ->param('required', null, new Boolean(), 'Is column required?')
+ ->param('default', null, new URL(), 'Default value for column when not provided. Cannot be set when column is required.', true)
+ ->param('array', false, new Boolean(), 'Is column an array?', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/URL/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/URL/Update.php
new file mode 100644
index 0000000000..82ab8fa614
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/URL/Update.php
@@ -0,0 +1,67 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/columns/url/:key')
+ ->desc('Update URL column')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].tables.[tableId].columns.[columnId].update')
+ ->label('audits.event', 'column.update')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/update-url-attribute.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('key', '', new Key(), 'Column Key.')
+ ->param('required', null, new Boolean(), 'Is column required?')
+ ->param('default', null, new Nullable(new URL()), 'Default value for column when not provided. Cannot be set when column is required.')
+ ->param('newKey', null, new Key(), 'New Column Key.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/XList.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/XList.php
new file mode 100644
index 0000000000..b6578777b0
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Columns/XList.php
@@ -0,0 +1,55 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/columns')
+ ->desc('List columns')
+ ->groups(['api', 'database'])
+ ->label('scope', 'tables.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/list-attributes.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel()
+ )
+ ]
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('queries', [], new Columns(), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long. You may filter on the following attributes: ' . implode(', ', Columns::ALLOWED_COLUMNS), true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Create.php
new file mode 100644
index 0000000000..b80cf4f773
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Create.php
@@ -0,0 +1,67 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/tables')
+ ->desc('Create table')
+ ->groups(['api', 'database'])
+ ->label('event', 'databases.[databaseId].tables.[tableId].create')
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('audits.event', 'table.create')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{response.$id}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: null,
+ name: self::getName(),
+ description: '/docs/references/databases/create-collection.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_CREATED,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new CustomId(), 'Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can\'t start with a special char. Max length is 36 chars.')
+ ->param('name', '', new Text(128), 'Table name. Max length: 128 chars.')
+ ->param('permissions', null, new Permissions(APP_LIMIT_ARRAY_PARAMS_SIZE), 'An array of permissions strings. By default, no user is granted with any permissions. [Learn more about permissions](https://appwrite.io/docs/permissions).', true)
+ ->param('rowSecurity', false, new Boolean(true), 'Enables configuring permissions for individual rows. A user needs one of row or table level permissions to access a row. [Learn more about permissions](https://appwrite.io/docs/permissions).', true)
+ ->param('enabled', true, new Boolean(), 'Is table enabled? When set to \'disabled\', users cannot access the table but Server SDKs with and API key can still read and write to the table. No data is lost when this is toggled.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Delete.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Delete.php
new file mode 100644
index 0000000000..2465496023
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Delete.php
@@ -0,0 +1,60 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_DELETE)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId')
+ ->desc('Delete table')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].tables.[tableId].delete')
+ ->label('audits.event', 'table.delete')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: null,
+ name: self::getName(),
+ description: '/docs/references/databases/delete-collection.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_NOCONTENT,
+ model: UtopiaResponse::MODEL_NONE,
+ )
+ ],
+ contentType: ContentType::NONE
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Get.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Get.php
new file mode 100644
index 0000000000..dec3a879a4
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Get.php
@@ -0,0 +1,55 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId')
+ ->desc('Get table')
+ ->groups(['api', 'database'])
+ ->label('scope', 'tables.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: null,
+ name: self::getName(),
+ description: '/docs/references/databases/get-collection.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->inject('response')
+ ->inject('dbForProject')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Indexes/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Indexes/Create.php
new file mode 100644
index 0000000000..92397cd460
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Indexes/Create.php
@@ -0,0 +1,71 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/indexes')
+ ->desc('Create index')
+ ->groups(['api', 'database'])
+ ->label('event', 'databases.[databaseId].tables.[tableId].indexes.[indexId].create')
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('audits.event', 'index.create')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: 'createIndex', // getName needs to be different from parent action to avoid conflict in path name
+ description: '/docs/references/databases/create-index.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_ACCEPTED,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID. You can create a new table using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
+ ->param('key', null, new Key(), 'Index Key.')
+ ->param('type', null, new WhiteList([Database::INDEX_KEY, Database::INDEX_FULLTEXT, Database::INDEX_UNIQUE]), 'Index type.')
+ ->param('columns', null, new ArrayList(new Key(true), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Array of columns to index. Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' columns are allowed, each 32 characters long.')
+ ->param('orders', [], new ArrayList(new WhiteList(['ASC', 'DESC'], false, Database::VAR_STRING), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Array of index orders. Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' orders are allowed.', true)
+ ->param('lengths', [], new ArrayList(new Nullable(new Integer()), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Length of index. Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE, optional: true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Indexes/Delete.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Indexes/Delete.php
new file mode 100644
index 0000000000..0fec37eec3
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Indexes/Delete.php
@@ -0,0 +1,66 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_DELETE)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/indexes/:key')
+ ->desc('Delete index')
+ ->groups(['api', 'database'])
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].tables.[tableId].indexes.[indexId].update')
+ ->label('audits.event', 'index.delete')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: 'deleteIndex', // getName needs to be different from parent action to avoid conflict in path name
+ description: '/docs/references/databases/delete-index.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_NOCONTENT,
+ model: UtopiaResponse::MODEL_NONE,
+ )
+ ],
+ contentType: ContentType::NONE
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID. You can create a new table using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
+ ->param('key', '', new Key(), 'Index Key.')
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForDatabase')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Indexes/Get.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Indexes/Get.php
new file mode 100644
index 0000000000..9a63fa79c3
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Indexes/Get.php
@@ -0,0 +1,57 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/indexes/:key')
+ ->desc('Get index')
+ ->groups(['api', 'database'])
+ ->label('scope', 'tables.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: 'getIndex', // getName needs to be different from parent action to avoid conflict in path name
+ description: '/docs/references/databases/get-index.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID. You can create a new table using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
+ ->param('key', null, new Key(), 'Index Key.')
+ ->inject('response')
+ ->inject('dbForProject')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Indexes/XList.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Indexes/XList.php
new file mode 100644
index 0000000000..85685cdd6c
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Indexes/XList.php
@@ -0,0 +1,57 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/indexes')
+ ->desc('List indexes')
+ ->groups(['api', 'database'])
+ ->label('scope', 'tables.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: 'listIndexes', // getName needs to be different from parent action to avoid conflict in path name
+ description: '/docs/references/databases/list-indexes.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID. You can create a new table using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
+ ->param('queries', [], new Indexes(), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long. You may filter on the following attributes: ' . implode(', ', Indexes::ALLOWED_ATTRIBUTES), true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Logs/XList.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Logs/XList.php
new file mode 100644
index 0000000000..d18cae9d6d
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Logs/XList.php
@@ -0,0 +1,55 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/logs')
+ ->desc('List table logs')
+ ->groups(['api', 'database'])
+ ->label('scope', 'tables.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: 'listLogs', // getName needs to be different from parent action to avoid conflict in path name
+ description: '/docs/references/databases/get-collection-logs.md',
+ auth: [AuthType::ADMIN],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('queries', [], new Queries([new Limit(), new Offset()]), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Only supported methods are limit and offset', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('locale')
+ ->inject('geodb')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Bulk/Delete.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Bulk/Delete.php
new file mode 100644
index 0000000000..a29d73aeee
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Bulk/Delete.php
@@ -0,0 +1,65 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_DELETE)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/rows')
+ ->desc('Delete rows')
+ ->groups(['api', 'database'])
+ ->label('scope', 'rows.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('audits.event', 'rows.delete')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
+ ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT)
+ ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/delete-documents.md',
+ auth: [AuthType::ADMIN, AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID. You can create a new table using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
+ ->param('queries', [], new ArrayList(new Text(APP_LIMIT_ARRAY_ELEMENT_SIZE), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForStatsUsage')
+ ->inject('plan')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Bulk/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Bulk/Update.php
new file mode 100644
index 0000000000..529d4b0b96
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Bulk/Update.php
@@ -0,0 +1,67 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/rows')
+ ->desc('Update rows')
+ ->groups(['api', 'database'])
+ ->label('scope', 'rows.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('audits.event', 'rows.update')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
+ ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT * 2)
+ ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/update-documents.md',
+ auth: [AuthType::ADMIN, AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('data', [], new JSON(), 'Row data as JSON object. Include only column and value pairs to be updated.', true)
+ ->param('queries', [], new ArrayList(new Text(APP_LIMIT_ARRAY_ELEMENT_SIZE), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForStatsUsage')
+ ->inject('plan')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Bulk/Upsert.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Bulk/Upsert.php
new file mode 100644
index 0000000000..2bda5f0172
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Bulk/Upsert.php
@@ -0,0 +1,67 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PUT)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/rows')
+ ->desc('Create or update rows')
+ ->groups(['api', 'database'])
+ ->label('scope', 'rows.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('audits.event', 'row.create')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
+ ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT * 2)
+ ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
+ ->label('sdk', [
+ new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/upsert-documents.md',
+ auth: [AuthType::ADMIN, AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_CREATED,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON,
+ )
+ ])
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('rows', [], fn (array $plan) => new ArrayList(new JSON(), $plan['databasesBatchSize'] ?? APP_LIMIT_DATABASE_BATCH), 'Array of row data as JSON objects. May contain partial rows.', false, ['plan'])
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForStatsUsage')
+ ->inject('plan')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Column/Decrement.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Column/Decrement.php
new file mode 100644
index 0000000000..a0761f0bd2
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Column/Decrement.php
@@ -0,0 +1,69 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/rows/:rowId/:column/decrement')
+ ->desc('Decrement row column')
+ ->groups(['api', 'database'])
+ ->label('event', 'databases.[databaseId].tables.[tableId].rows.[rowId].decrement')
+ ->label('scope', 'rows.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('audits.event', 'rows.decrement')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
+ ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT * 2)
+ ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/decrement-document-attribute.md',
+ auth: [AuthType::ADMIN, AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('rowId', '', new UID(), 'Row ID.')
+ ->param('column', '', new Key(), 'Column key.')
+ ->param('value', 1, new Numeric(), 'Value to increment the column by. The value must be a number.', true)
+ ->param('min', null, new Numeric(), 'Minimum value for the column. If the current value is lesser than this value, an exception will be thrown.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->inject('queueForStatsUsage')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Column/Increment.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Column/Increment.php
new file mode 100644
index 0000000000..d28b2a3968
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Column/Increment.php
@@ -0,0 +1,69 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/rows/:rowId/:column/increment')
+ ->desc('Increment row column')
+ ->groups(['api', 'database'])
+ ->label('event', 'databases.[databaseId].tables.[tableId].rows.[rowId].increment')
+ ->label('scope', 'rows.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('audits.event', 'rows.increment')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
+ ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT * 2)
+ ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/increment-document-attribute.md',
+ auth: [AuthType::ADMIN, AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('rowId', '', new UID(), 'Row ID.')
+ ->param('column', '', new Key(), 'Column key.')
+ ->param('value', 1, new Numeric(), 'Value to increment the column by. The value must be a number.', true)
+ ->param('max', null, new Numeric(), 'Maximum value for the column. If the current value is greater than this value, an error will be thrown.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->inject('queueForStatsUsage')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Create.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Create.php
new file mode 100644
index 0000000000..bba4960b69
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Create.php
@@ -0,0 +1,106 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_POST)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/rows')
+ ->desc('Create row')
+ ->groups(['api', 'database'])
+ ->label('scope', 'rows.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('audits.event', 'row.create')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
+ ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT * 2)
+ ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
+ ->label('sdk', [
+ new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/create-document.md',
+ auth: [AuthType::SESSION, AuthType::KEY, AuthType::JWT],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_CREATED,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON,
+ parameters: [
+ new Parameter('databaseId', optional: false),
+ new Parameter('tableId', optional: false),
+ new Parameter('rowId', optional: false),
+ new Parameter('data', optional: false),
+ new Parameter('permissions', optional: true),
+ ]
+ ),
+ new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: $this->getBulkActionName(self::getName()),
+ description: '/docs/references/databases/create-documents.md',
+ auth: [AuthType::ADMIN, AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_CREATED,
+ model: $this->getBulkResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON,
+ parameters: [
+ new Parameter('databaseId', optional: false),
+ new Parameter('tableId', optional: false),
+ new Parameter('rows', optional: false),
+ ]
+ )
+ ])
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('rowId', '', new CustomId(), 'Row ID. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can\'t start with a special char. Max length is 36 chars.', true)
+ ->param('tableId', '', new UID(), 'Table ID. You can create a new table using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection). Make sure to define columns before creating rows.')
+ ->param('data', [], new JSON(), 'Row data as JSON object.', true)
+ ->param('permissions', null, new Permissions(APP_LIMIT_ARRAY_PARAMS_SIZE, [Database::PERMISSION_READ, Database::PERMISSION_UPDATE, Database::PERMISSION_DELETE, Database::PERMISSION_WRITE]), 'An array of permissions strings. By default, only the current user is granted all permissions. [Learn more about permissions](https://appwrite.io/docs/permissions).', true)
+ ->param('rows', [], fn (array $plan) => new ArrayList(new JSON(), $plan['databasesBatchSize'] ?? APP_LIMIT_DATABASE_BATCH), 'Array of documents data as JSON objects.', true, ['plan'])
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('user')
+ ->inject('queueForEvents')
+ ->inject('queueForStatsUsage')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Delete.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Delete.php
new file mode 100644
index 0000000000..22c25d5b16
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Delete.php
@@ -0,0 +1,71 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_DELETE)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/rows/:rowId')
+ ->desc('Delete row')
+ ->groups(['api', 'database'])
+ ->label('scope', 'rows.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].tables.[tableId].rows.[rowId].delete')
+ ->label('audits.event', 'row.delete')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}/row/{request.rowId}')
+ ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
+ ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT)
+ ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/delete-document.md',
+ auth: [AuthType::SESSION, AuthType::KEY, AuthType::JWT],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_NOCONTENT,
+ model: UtopiaResponse::MODEL_NONE,
+ )
+ ],
+ contentType: ContentType::NONE
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID. You can create a new table using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
+ ->param('rowId', '', new UID(), 'Row ID.')
+ ->inject('requestTimestamp')
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->inject('queueForStatsUsage')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Get.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Get.php
new file mode 100644
index 0000000000..0266781728
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Get.php
@@ -0,0 +1,60 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/rows/:rowId')
+ ->desc('Get row')
+ ->groups(['api', 'database'])
+ ->label('scope', 'rows.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/get-document.md',
+ auth: [AuthType::SESSION, AuthType::KEY, AuthType::JWT],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID. You can create a new table using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
+ ->param('rowId', '', new UID(), 'Row ID.')
+ ->param('queries', [], new ArrayList(new Text(APP_LIMIT_ARRAY_ELEMENT_SIZE), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForStatsUsage')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Logs/XList.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Logs/XList.php
new file mode 100644
index 0000000000..ad42f16f44
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Logs/XList.php
@@ -0,0 +1,56 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/rows/:rowId/logs')
+ ->desc('List row logs')
+ ->groups(['api', 'database'])
+ ->label('scope', 'rows.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: 'logs',
+ name: self::getName(),
+ description: '/docs/references/databases/get-document-logs.md',
+ auth: [AuthType::ADMIN],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON,
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Collection ID.')
+ ->param('rowId', '', new UID(), 'Row ID.')
+ ->param('queries', [], new Queries([new Limit(), new Offset()]), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Only supported methods are limit and offset', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('locale')
+ ->inject('geodb')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Update.php
new file mode 100644
index 0000000000..15796c3b6b
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Update.php
@@ -0,0 +1,70 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PATCH)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/rows/:rowId')
+ ->desc('Update row')
+ ->groups(['api', 'database'])
+ ->label('event', 'databases.[databaseId].tables.[tableId].rows.[rowId].update')
+ ->label('scope', 'rows.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('audits.event', 'row.update')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}/row/{response.$id}')
+ ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
+ ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT * 2)
+ ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/update-document.md',
+ auth: [AuthType::SESSION, AuthType::KEY, AuthType::JWT],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('rowId', '', new UID(), 'Row ID.')
+ ->param('data', [], new JSON(), 'Row data as JSON object. Include only columns and value pairs to be updated.', true)
+ ->param('permissions', null, new Permissions(APP_LIMIT_ARRAY_PARAMS_SIZE, [Database::PERMISSION_READ, Database::PERMISSION_UPDATE, Database::PERMISSION_DELETE, Database::PERMISSION_WRITE]), 'An array of permissions strings. By default, the current permissions are inherited. [Learn more about permissions](https://appwrite.io/docs/permissions).', true)
+ ->inject('requestTimestamp')
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->inject('queueForStatsUsage')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Upsert.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Upsert.php
new file mode 100644
index 0000000000..42a79e8a72
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/Upsert.php
@@ -0,0 +1,72 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PUT)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/rows/:rowId')
+ ->desc('Create or update a row')
+ ->groups(['api', 'database'])
+ ->label('event', 'databases.[databaseId].tables.[tableId].rows.[rowId].upsert')
+ ->label('scope', 'rows.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('audits.event', 'row.upsert')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}/row/{response.$id}')
+ ->label('abuse-key', 'ip:{ip},method:{method},url:{url},userId:{userId}')
+ ->label('abuse-limit', APP_LIMIT_WRITE_RATE_DEFAULT * 2)
+ ->label('abuse-time', APP_LIMIT_WRITE_RATE_PERIOD_DEFAULT)
+ ->label('sdk', [
+ new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/upsert-document.md',
+ auth: [AuthType::SESSION, AuthType::KEY, AuthType::JWT],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_CREATED,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ),
+ ])
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('rowId', '', new UID(), 'Row ID.')
+ ->param('data', [], new JSON(), 'Row data as JSON object. Include all required columns of the row to be created or updated.', true)
+ ->param('permissions', null, new Permissions(APP_LIMIT_ARRAY_PARAMS_SIZE, [Database::PERMISSION_READ, Database::PERMISSION_UPDATE, Database::PERMISSION_DELETE, Database::PERMISSION_WRITE]), 'An array of permissions strings. By default, the current permissions are inherited. [Learn more about permissions](https://appwrite.io/docs/permissions).', true)
+ ->inject('requestTimestamp')
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->inject('queueForStatsUsage')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/XList.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/XList.php
new file mode 100644
index 0000000000..7e942f4842
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Rows/XList.php
@@ -0,0 +1,59 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/rows')
+ ->desc('List rows')
+ ->groups(['api', 'database'])
+ ->label('scope', 'rows.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: $this->getSdkGroup(),
+ name: self::getName(),
+ description: '/docs/references/databases/list-documents.md',
+ auth: [AuthType::SESSION, AuthType::KEY, AuthType::JWT],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID. You can create a new table using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).')
+ ->param('queries', [], new ArrayList(new Text(APP_LIMIT_ARRAY_ELEMENT_SIZE), APP_LIMIT_ARRAY_PARAMS_SIZE), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForStatsUsage')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Update.php
new file mode 100644
index 0000000000..b19dc143b9
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Update.php
@@ -0,0 +1,66 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PUT)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId')
+ ->desc('Update table')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'tables.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].tables.[tableId].update')
+ ->label('audits.event', 'table.update')
+ ->label('audits.resource', 'database/{request.databaseId}/table/{request.tableId}')
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: null,
+ name: self::getName(),
+ description: '/docs/references/databases/update-collection.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: UtopiaResponse::MODEL_TABLE,
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('tableId', '', new UID(), 'Table ID.')
+ ->param('name', null, new Text(128), 'Table name. Max length: 128 chars.')
+ ->param('permissions', null, new Permissions(APP_LIMIT_ARRAY_PARAMS_SIZE), 'An array of permission strings. By default, the current permissions are inherited. [Learn more about permissions](https://appwrite.io/docs/permissions).', true)
+ ->param('rowSecurity', false, new Boolean(true), 'Enables configuring permissions for individual rows. A user needs one of row or table level permissions to access a document. [Learn more about permissions](https://appwrite.io/docs/permissions).', true)
+ ->param('enabled', true, new Boolean(), 'Is table enabled? When set to \'disabled\', users cannot access the table but Server SDKs with and API key can still read and write to the table. No data is lost when this is toggled.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Usage/Get.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Usage/Get.php
new file mode 100644
index 0000000000..cede0762d8
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/Usage/Get.php
@@ -0,0 +1,57 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/:databaseId/tables/:tableId/usage')
+ ->desc('Get table usage stats')
+ ->groups(['api', 'database', 'usage'])
+ ->label('scope', 'tables.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: null,
+ name: self::getName(),
+ description: '/docs/references/databases/get-collection-usage.md',
+ auth: [AuthType::ADMIN],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON,
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('range', '30d', new WhiteList(['24h', '30d', '90d'], true), 'Date range.', true)
+ ->param('tableId', '', new UID(), 'Collection ID.')
+ ->inject('response')
+ ->inject('dbForProject')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/XList.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/XList.php
new file mode 100644
index 0000000000..24034f7f0a
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Tables/XList.php
@@ -0,0 +1,58 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/:databaseId/tables')
+ ->desc('List tables')
+ ->groups(['api', 'database'])
+ ->label('scope', 'tables.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: $this->getSdkNamespace(),
+ group: null,
+ name: self::getName(),
+ description: '/docs/references/databases/list-collections.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: $this->getResponseModel(),
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('queries', [], new Tables(), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long. You may filter on the following attributes: ' . implode(', ', Tables::ALLOWED_COLUMNS), true)
+ ->param('search', '', new Text(256), 'Search term to filter your list results. Max length: 256 chars.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->callback($this->action(...));
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Update.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Update.php
new file mode 100644
index 0000000000..a746f4ce4c
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Update.php
@@ -0,0 +1,78 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_PUT)
+ ->setHttpPath('/v1/databases/:databaseId')
+ ->desc('Update database')
+ ->groups(['api', 'database', 'schema'])
+ ->label('scope', 'databases.write')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('event', 'databases.[databaseId].update')
+ ->label('audits.event', 'database.update')
+ ->label('audits.resource', 'database/{response.$id}')
+ ->label('sdk', new Method(
+ namespace: 'databases',
+ group: 'databases',
+ name: 'update',
+ description: '/docs/references/databases/update.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: UtopiaResponse::MODEL_DATABASE,
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('name', null, new Text(128), 'Database name. Max length: 128 chars.')
+ ->param('enabled', true, new Boolean(), 'Is database enabled? When set to \'disabled\', users cannot access the database but Server SDKs with an API key can still read and write to the database. No data is lost when this is toggled.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->inject('queueForEvents')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $name, bool $enabled, UtopiaResponse $response, Database $dbForProject, Event $queueForEvents): void
+ {
+ $database = $dbForProject->getDocument('databases', $databaseId);
+
+ if ($database->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $database = $dbForProject->updateDocument('databases', $databaseId, $database
+ ->setAttribute('name', $name)
+ ->setAttribute('enabled', $enabled)
+ ->setAttribute('search', implode(' ', [$databaseId, $name])));
+
+ $queueForEvents->setParam('databaseId', $database->getId());
+
+ $response->dynamic($database, UtopiaResponse::MODEL_DATABASE);
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Usage/Get.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Usage/Get.php
new file mode 100644
index 0000000000..5482d25269
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Usage/Get.php
@@ -0,0 +1,139 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/:databaseId/usage')
+ ->desc('Get database usage stats')
+ ->groups(['api', 'database', 'usage'])
+ ->label('scope', 'collections.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: 'databases',
+ group: null,
+ name: 'getUsage',
+ description: '/docs/references/databases/get-database-usage.md',
+ auth: [AuthType::ADMIN],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: UtopiaResponse::MODEL_USAGE_DATABASE,
+ )
+ ],
+ contentType: ContentType::JSON,
+ ))
+ ->param('databaseId', '', new UID(), 'Database ID.')
+ ->param('range', '30d', new WhiteList(['24h', '30d', '90d'], true), 'Date range.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $databaseId, string $range, UtopiaResponse $response, Database $dbForProject): void
+ {
+ $database = $dbForProject->getDocument('databases', $databaseId);
+
+ if ($database->isEmpty()) {
+ throw new Exception(Exception::DATABASE_NOT_FOUND);
+ }
+
+ $periods = Config::getParam('usage', []);
+ $stats = $usage = [];
+ $days = $periods[$range];
+ $metrics = [
+ str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_COLLECTIONS),
+ str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_DOCUMENTS),
+ str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASE_ID_STORAGE),
+ str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASES_OPERATIONS_READS),
+ str_replace('{databaseInternalId}', $database->getSequence(), METRIC_DATABASES_OPERATIONS_WRITES)
+ ];
+
+ Authorization::skip(function () use ($dbForProject, $days, $metrics, &$stats) {
+ foreach ($metrics as $metric) {
+ $result = $dbForProject->findOne('stats', [
+ Query::equal('metric', [$metric]),
+ Query::equal('period', ['inf'])
+ ]);
+
+ $stats[$metric]['total'] = $result['value'] ?? 0;
+ $limit = $days['limit'];
+ $period = $days['period'];
+ $results = $dbForProject->find('stats', [
+ Query::equal('metric', [$metric]),
+ Query::equal('period', [$period]),
+ Query::limit($limit),
+ Query::orderDesc('time'),
+ ]);
+ $stats[$metric]['data'] = [];
+ foreach ($results as $result) {
+ $stats[$metric]['data'][$result->getAttribute('time')] = [
+ 'value' => $result->getAttribute('value'),
+ ];
+ }
+ }
+ });
+
+ $format = match ($days['period']) {
+ '1h' => 'Y-m-d\TH:00:00.000P',
+ '1d' => 'Y-m-d\T00:00:00.000P',
+ };
+
+ foreach ($metrics as $metric) {
+ $usage[$metric]['total'] = $stats[$metric]['total'];
+ $usage[$metric]['data'] = [];
+ $leap = time() - ($days['limit'] * $days['factor']);
+ while ($leap < time()) {
+ $leap += $days['factor'];
+ $formatDate = date($format, $leap);
+ $usage[$metric]['data'][] = [
+ 'value' => $stats[$metric]['data'][$formatDate]['value'] ?? 0,
+ 'date' => $formatDate,
+ ];
+ }
+ }
+
+ $response->dynamic(new Document([
+ 'range' => $range,
+ 'collectionsTotal' => $usage[$metrics[0]]['total'],
+ 'tablesTotal' => $usage[$metrics[0]]['total'],
+ 'documentsTotal' => $usage[$metrics[1]]['total'],
+ 'rowsTotal' => $usage[$metrics[1]]['total'],
+ 'storageTotal' => $usage[$metrics[2]]['total'],
+ 'databaseReadsTotal' => $usage[$metrics[3]]['total'],
+ 'databaseWritesTotal' => $usage[$metrics[4]]['total'],
+ 'collections' => $usage[$metrics[0]]['data'],
+ 'tables' => $usage[$metrics[0]]['data'],
+ 'documents' => $usage[$metrics[1]]['data'],
+ 'rows' => $usage[$metrics[1]]['data'],
+ 'storage' => $usage[$metrics[2]]['data'],
+ 'databaseReads' => $usage[$metrics[3]]['data'],
+ 'databaseWrites' => $usage[$metrics[4]]['data'],
+ ]), UtopiaResponse::MODEL_USAGE_DATABASE);
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/Usage/XList.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Usage/XList.php
new file mode 100644
index 0000000000..fd3a95cd24
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/Usage/XList.php
@@ -0,0 +1,133 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases/usage')
+ ->desc('Get databases usage stats')
+ ->groups(['api', 'database', 'usage'])
+ ->label('scope', 'collections.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: 'databases',
+ group: null,
+ name: 'listUsages',
+ description: '/docs/references/databases/get-usage.md',
+ auth: [AuthType::ADMIN],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: UtopiaResponse::MODEL_USAGE_DATABASES,
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('range', '30d', new WhiteList(['24h', '30d', '90d'], true), 'Date range.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->callback($this->action(...));
+ }
+
+ public function action(string $range, UtopiaResponse $response, Database $dbForProject): void
+ {
+
+ $periods = Config::getParam('usage', []);
+ $stats = $usage = [];
+ $days = $periods[$range];
+ $metrics = [
+ METRIC_DATABASES,
+ METRIC_COLLECTIONS,
+ METRIC_DOCUMENTS,
+ METRIC_DATABASES_STORAGE,
+ METRIC_DATABASES_OPERATIONS_READS,
+ METRIC_DATABASES_OPERATIONS_WRITES,
+ ];
+
+ Authorization::skip(function () use ($dbForProject, $days, $metrics, &$stats) {
+ foreach ($metrics as $metric) {
+ $result = $dbForProject->findOne('stats', [
+ Query::equal('metric', [$metric]),
+ Query::equal('period', ['inf'])
+ ]);
+
+ $stats[$metric]['total'] = $result['value'] ?? 0;
+ $limit = $days['limit'];
+ $period = $days['period'];
+ $results = $dbForProject->find('stats', [
+ Query::equal('metric', [$metric]),
+ Query::equal('period', [$period]),
+ Query::limit($limit),
+ Query::orderDesc('time'),
+ ]);
+ $stats[$metric]['data'] = [];
+ foreach ($results as $result) {
+ $stats[$metric]['data'][$result->getAttribute('time')] = [
+ 'value' => $result->getAttribute('value'),
+ ];
+ }
+ }
+ });
+
+ $format = match ($days['period']) {
+ '1h' => 'Y-m-d\TH:00:00.000P',
+ '1d' => 'Y-m-d\T00:00:00.000P',
+ };
+
+ foreach ($metrics as $metric) {
+ $usage[$metric]['total'] = $stats[$metric]['total'];
+ $usage[$metric]['data'] = [];
+ $leap = time() - ($days['limit'] * $days['factor']);
+ while ($leap < time()) {
+ $leap += $days['factor'];
+ $formatDate = date($format, $leap);
+ $usage[$metric]['data'][] = [
+ 'value' => $stats[$metric]['data'][$formatDate]['value'] ?? 0,
+ 'date' => $formatDate,
+ ];
+ }
+ }
+ $response->dynamic(new Document([
+ 'range' => $range,
+ 'databasesTotal' => $usage[$metrics[0]]['total'],
+ 'collectionsTotal' => $usage[$metrics[1]]['total'],
+ 'tablesTotal' => $usage[$metrics[1]]['total'],
+ 'documentsTotal' => $usage[$metrics[2]]['total'],
+ 'rowsTotal' => $usage[$metrics[2]]['total'],
+ 'storageTotal' => $usage[$metrics[3]]['total'],
+ 'databasesReadsTotal' => $usage[$metrics[4]]['total'],
+ 'databasesWritesTotal' => $usage[$metrics[5]]['total'],
+ 'databases' => $usage[$metrics[0]]['data'],
+ 'collections' => $usage[$metrics[1]]['data'],
+ 'tables' => $usage[$metrics[1]]['data'],
+ 'documents' => $usage[$metrics[2]]['data'],
+ 'rows' => $usage[$metrics[2]]['data'],
+ 'storage' => $usage[$metrics[3]]['data'],
+ 'databasesReads' => $usage[$metrics[4]]['data'],
+ 'databasesWrites' => $usage[$metrics[5]]['data'],
+ ]), UtopiaResponse::MODEL_USAGE_DATABASES);
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Databases/XList.php b/src/Appwrite/Platform/Modules/Databases/Http/Databases/XList.php
new file mode 100644
index 0000000000..52f3fd2b55
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Databases/XList.php
@@ -0,0 +1,106 @@
+setHttpMethod(self::HTTP_REQUEST_METHOD_GET)
+ ->setHttpPath('/v1/databases')
+ ->desc('List databases')
+ ->groups(['api', 'database'])
+ ->label('scope', 'databases.read')
+ ->label('resourceType', RESOURCE_TYPE_DATABASES)
+ ->label('sdk', new Method(
+ namespace: 'databases',
+ group: 'databases',
+ name: 'list',
+ description: '/docs/references/databases/list.md',
+ auth: [AuthType::KEY],
+ responses: [
+ new SDKResponse(
+ code: SwooleResponse::STATUS_CODE_OK,
+ model: UtopiaResponse::MODEL_DATABASE_LIST,
+ )
+ ],
+ contentType: ContentType::JSON
+ ))
+ ->param('queries', [], new Databases(), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long. You may filter on the following attributes: ' . implode(', ', Databases::ALLOWED_ATTRIBUTES), true)
+ ->param('search', '', new Text(256), 'Search term to filter your list results. Max length: 256 chars.', true)
+ ->inject('response')
+ ->inject('dbForProject')
+ ->callback($this->action(...));
+ }
+
+ public function action(array $queries, string $search, UtopiaResponse $response, Database $dbForProject): void
+ {
+ $queries = Query::parseQueries($queries);
+
+ if (!empty($search)) {
+ $queries[] = Query::search('search', $search);
+ }
+
+ /**
+ * Get cursor document if there was a cursor query, we use array_filter and reset for reference $cursor to $queries
+ */
+ $cursor = \array_filter($queries, function ($query) {
+ return \in_array($query->getMethod(), [Query::TYPE_CURSOR_AFTER, Query::TYPE_CURSOR_BEFORE]);
+ });
+ $cursor = reset($cursor);
+ if ($cursor) {
+ /** @var Query $cursor */
+
+ $validator = new Cursor();
+ if (!$validator->isValid($cursor)) {
+ throw new Exception(Exception::GENERAL_QUERY_INVALID, $validator->getDescription());
+ }
+
+ $databaseId = $cursor->getValue();
+ $cursorDocument = $dbForProject->getDocument('databases', $databaseId);
+
+ if ($cursorDocument->isEmpty()) {
+ throw new Exception(Exception::GENERAL_CURSOR_NOT_FOUND, "Database '{$databaseId}' for the 'cursor' value not found.");
+ }
+
+ $cursor->setValue($cursorDocument);
+ }
+
+ try {
+ $databases = $dbForProject->find('databases', $queries);
+ $total = $dbForProject->count('databases', $queries, APP_LIMIT_COUNT);
+ } catch (OrderException $e) {
+ throw new Exception(Exception::DATABASE_QUERY_ORDER_NULL, "The order column '{$e->getAttribute()}' had a null value. Cursor pagination requires all rows order column values are non-null.");
+ } catch (QueryException) {
+ throw new Exception(Exception::GENERAL_QUERY_INVALID);
+ }
+
+ $response->dynamic(new Document([
+ 'databases' => $databases,
+ 'total' => $total,
+ ]), UtopiaResponse::MODEL_DATABASE_LIST);
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Http/Init/Timeout.php b/src/Appwrite/Platform/Modules/Databases/Http/Init/Timeout.php
new file mode 100644
index 0000000000..19e202981b
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Http/Init/Timeout.php
@@ -0,0 +1,35 @@
+setType(Action::TYPE_INIT)
+ ->groups(['api', 'database'])
+ ->inject('request')
+ ->inject('dbForProject')
+ ->callback(function (Request $request, Database $dbForProject) {
+ $timeout = \intval($request->getHeader('x-appwrite-timeout'));
+
+ if (!empty($timeout) && App::isDevelopment()) {
+ $dbForProject->setTimeout($timeout);
+ }
+ });
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Module.php b/src/Appwrite/Platform/Modules/Databases/Module.php
new file mode 100644
index 0000000000..bf336413d4
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Module.php
@@ -0,0 +1,18 @@
+addService('http', new Http());
+ $this->addService('workers', new Workers());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Services/Http.php b/src/Appwrite/Platform/Modules/Databases/Services/Http.php
new file mode 100644
index 0000000000..d2f66f3657
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Services/Http.php
@@ -0,0 +1,28 @@
+type = Service::TYPE_HTTP;
+
+ // Project database timeout init hook!
+ $this->addAction(Timeout::getName(), new Timeout());
+
+ foreach ([
+ DatabasesRegistry::class,
+ CollectionsRegistry::class,
+ TablesRegistry::class,
+ ] as $registrar) {
+ new $registrar($this);
+ }
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Services/Registry/Base.php b/src/Appwrite/Platform/Modules/Databases/Services/Registry/Base.php
new file mode 100644
index 0000000000..43bc4b2959
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Services/Registry/Base.php
@@ -0,0 +1,24 @@
+register($service);
+ }
+
+ /**
+ * Register all HTTP actions related to this module.
+ */
+ abstract protected function register(Service $service): void;
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Services/Registry/Collections.php b/src/Appwrite/Platform/Modules/Databases/Services/Registry/Collections.php
new file mode 100644
index 0000000000..bb0002ed47
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Services/Registry/Collections.php
@@ -0,0 +1,155 @@
+registerCollectionActions($service);
+ $this->registerDocumentActions($service);
+ $this->registerAttributeActions($service);
+ $this->registerIndexActions($service);
+ }
+
+ private function registerCollectionActions(Service $service): void
+ {
+ $service->addAction(CreateCollection::getName(), new CreateCollection());
+ $service->addAction(GetCollection::getName(), new GetCollection());
+ $service->addAction(UpdateCollection::getName(), new UpdateCollection());
+ $service->addAction(DeleteCollection::getName(), new DeleteCollection());
+ $service->addAction(ListCollections::getName(), new ListCollections());
+ $service->addAction(ListCollectionLogs::getName(), new ListCollectionLogs());
+ $service->addAction(GetCollectionUsage::getName(), new GetCollectionUsage());
+ }
+
+ private function registerDocumentActions(Service $service): void
+ {
+ $service->addAction(CreateDocument::getName(), new CreateDocument());
+ $service->addAction(GetDocument::getName(), new GetDocument());
+ $service->addAction(UpdateDocument::getName(), new UpdateDocument());
+ $service->addAction(UpdateDocuments::getName(), new UpdateDocuments());
+ $service->addAction(UpsertDocument::getName(), new UpsertDocument());
+ $service->addAction(UpsertDocuments::getName(), new UpsertDocuments());
+ $service->addAction(DeleteDocument::getName(), new DeleteDocument());
+ $service->addAction(DeleteDocuments::getName(), new DeleteDocuments());
+ $service->addAction(ListDocuments::getName(), new ListDocuments());
+ $service->addAction(ListDocumentLogs::getName(), new ListDocumentLogs());
+ $service->addAction(IncrementDocumentAttribute::getName(), new IncrementDocumentAttribute());
+ $service->addAction(DecrementDocumentAttribute::getName(), new DecrementDocumentAttribute());
+
+ }
+
+ private function registerAttributeActions(Service $service): void
+ {
+ // Attribute top-level actions
+ $service->addAction(GetAttribute::getName(), new GetAttribute());
+ $service->addAction(DeleteAttribute::getName(), new DeleteAttribute());
+ $service->addAction(ListAttributes::getName(), new ListAttributes());
+
+ // Attribute: Boolean
+ $service->addAction(CreateBooleanAttribute::getName(), new CreateBooleanAttribute());
+ $service->addAction(UpdateBooleanAttribute::getName(), new UpdateBooleanAttribute());
+
+ // Attribute: Datetime
+ $service->addAction(CreateDatetimeAttribute::getName(), new CreateDatetimeAttribute());
+ $service->addAction(UpdateDatetimeAttribute::getName(), new UpdateDatetimeAttribute());
+
+ // Attribute: Email
+ $service->addAction(CreateEmailAttribute::getName(), new CreateEmailAttribute());
+ $service->addAction(UpdateEmailAttribute::getName(), new UpdateEmailAttribute());
+
+ // Attribute: Enum
+ $service->addAction(CreateEnumAttribute::getName(), new CreateEnumAttribute());
+ $service->addAction(UpdateEnumAttribute::getName(), new UpdateEnumAttribute());
+
+ // Attribute: Float
+ $service->addAction(CreateFloatAttribute::getName(), new CreateFloatAttribute());
+ $service->addAction(UpdateFloatAttribute::getName(), new UpdateFloatAttribute());
+
+ // Attribute: Integer
+ $service->addAction(CreateIntegerAttribute::getName(), new CreateIntegerAttribute());
+ $service->addAction(UpdateIntegerAttribute::getName(), new UpdateIntegerAttribute());
+
+ // Attribute: IP
+ $service->addAction(CreateIPAttribute::getName(), new CreateIPAttribute());
+ $service->addAction(UpdateIPAttribute::getName(), new UpdateIPAttribute());
+
+ // Attribute: Relationship
+ $service->addAction(CreateRelationshipAttribute::getName(), new CreateRelationshipAttribute());
+ $service->addAction(UpdateRelationshipAttribute::getName(), new UpdateRelationshipAttribute());
+
+ // Attribute: String
+ $service->addAction(CreateStringAttribute::getName(), new CreateStringAttribute());
+ $service->addAction(UpdateStringAttribute::getName(), new UpdateStringAttribute());
+
+ // Attribute: URL
+ $service->addAction(CreateURLAttribute::getName(), new CreateURLAttribute());
+ $service->addAction(UpdateURLAttribute::getName(), new UpdateURLAttribute());
+ }
+
+ private function registerIndexActions(Service $service): void
+ {
+ $service->addAction(CreateIndex::getName(), new CreateIndex());
+ $service->addAction(GetIndex::getName(), new GetIndex());
+ $service->addAction(DeleteIndex::getName(), new DeleteIndex());
+ $service->addAction(ListIndexes::getName(), new ListIndexes());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Services/Registry/Databases.php b/src/Appwrite/Platform/Modules/Databases/Services/Registry/Databases.php
new file mode 100644
index 0000000000..81c9174253
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Services/Registry/Databases.php
@@ -0,0 +1,31 @@
+addAction(CreateDatabase::getName(), new CreateDatabase());
+ $service->addAction(GetDatabase::getName(), new GetDatabase());
+ $service->addAction(UpdateDatabase::getName(), new UpdateDatabase());
+ $service->addAction(DeleteDatabase::getName(), new DeleteDatabase());
+ $service->addAction(ListDatabases::getName(), new ListDatabases());
+ $service->addAction(ListDatabaseLogs::getName(), new ListDatabaseLogs());
+ $service->addAction(GetDatabaseUsage::getName(), new GetDatabaseUsage());
+ $service->addAction(ListDatabaseUsage::getName(), new ListDatabaseUsage());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Services/Registry/Tables.php b/src/Appwrite/Platform/Modules/Databases/Services/Registry/Tables.php
new file mode 100644
index 0000000000..4ddadeece6
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Services/Registry/Tables.php
@@ -0,0 +1,154 @@
+registerTableActions($service);
+ $this->registerColumnActions($service);
+ $this->registerIndexActions($service);
+ $this->registerRowActions($service);
+ }
+
+ private function registerTableActions(Service $service): void
+ {
+ $service->addAction(CreateTable::getName(), new CreateTable());
+ $service->addAction(GetTable::getName(), new GetTable());
+ $service->addAction(UpdateTable::getName(), new UpdateTable());
+ $service->addAction(DeleteTable::getName(), new DeleteTable());
+ $service->addAction(ListTables::getName(), new ListTables());
+ $service->addAction(ListTableLogs::getName(), new ListTableLogs());
+ $service->addAction(GetTableUsage::getName(), new GetTableUsage());
+ }
+
+ private function registerColumnActions(Service $service): void
+ {
+ // Column top level actions
+ $service->addAction(GetColumn::getName(), new GetColumn());
+ $service->addAction(DeleteColumn::getName(), new DeleteColumn());
+ $service->addAction(ListColumns::getName(), new ListColumns());
+
+ // Column: Boolean
+ $service->addAction(CreateBoolean::getName(), new CreateBoolean());
+ $service->addAction(UpdateBoolean::getName(), new UpdateBoolean());
+
+ // Column: Datetime
+ $service->addAction(CreateDatetime::getName(), new CreateDatetime());
+ $service->addAction(UpdateDatetime::getName(), new UpdateDatetime());
+
+ // Column: Email
+ $service->addAction(CreateEmail::getName(), new CreateEmail());
+ $service->addAction(UpdateEmail::getName(), new UpdateEmail());
+
+ // Column: Enum
+ $service->addAction(CreateEnum::getName(), new CreateEnum());
+ $service->addAction(UpdateEnum::getName(), new UpdateEnum());
+
+ // Column: Float
+ $service->addAction(CreateFloat::getName(), new CreateFloat());
+ $service->addAction(UpdateFloat::getName(), new UpdateFloat());
+
+ // Column: Integer
+ $service->addAction(CreateInteger::getName(), new CreateInteger());
+ $service->addAction(UpdateInteger::getName(), new UpdateInteger());
+
+ // Column: IP
+ $service->addAction(CreateIP::getName(), new CreateIP());
+ $service->addAction(UpdateIP::getName(), new UpdateIP());
+
+ // Column: Relationship
+ $service->addAction(CreateRelationship::getName(), new CreateRelationship());
+ $service->addAction(UpdateRelationship::getName(), new UpdateRelationship());
+
+ // Column: String
+ $service->addAction(CreateString::getName(), new CreateString());
+ $service->addAction(UpdateString::getName(), new UpdateString());
+
+ // Column: URL
+ $service->addAction(CreateURL::getName(), new CreateURL());
+ $service->addAction(UpdateURL::getName(), new UpdateURL());
+ }
+
+ private function registerIndexActions(Service $service): void
+ {
+ $service->addAction(CreateColumnIndex::getName(), new CreateColumnIndex());
+ $service->addAction(GetColumnIndex::getName(), new GetColumnIndex());
+ $service->addAction(DeleteColumnIndex::getName(), new DeleteColumnIndex());
+ $service->addAction(ListColumnIndexes::getName(), new ListColumnIndexes());
+ }
+
+ private function registerRowActions(Service $service): void
+ {
+ $service->addAction(CreateRow::getName(), new CreateRow());
+ $service->addAction(GetRow::getName(), new GetRow());
+ $service->addAction(UpdateRow::getName(), new UpdateRow());
+ $service->addAction(UpdateRows::getName(), new UpdateRows());
+ $service->addAction(UpsertRow::getName(), new UpsertRow());
+ $service->addAction(UpsertRows::getName(), new UpsertRows());
+ $service->addAction(DeleteRow::getName(), new DeleteRow());
+ $service->addAction(DeleteRows::getName(), new DeleteRows());
+ $service->addAction(ListRows::getName(), new ListRows());
+ $service->addAction(ListRowLogs::getName(), new ListRowLogs());
+ $service->addAction(IncrementRowColumn::getName(), new IncrementRowColumn());
+ $service->addAction(DecrementRowColumn::getName(), new DecrementRowColumn());
+ }
+}
diff --git a/src/Appwrite/Platform/Modules/Databases/Services/Workers.php b/src/Appwrite/Platform/Modules/Databases/Services/Workers.php
new file mode 100644
index 0000000000..55388ea7ff
--- /dev/null
+++ b/src/Appwrite/Platform/Modules/Databases/Services/Workers.php
@@ -0,0 +1,15 @@
+type = Service::TYPE_WORKER;
+ $this->addAction(Databases::getName(), new Databases());
+ }
+}
diff --git a/src/Appwrite/Platform/Workers/Databases.php b/src/Appwrite/Platform/Modules/Databases/Workers/Databases.php
similarity index 90%
rename from src/Appwrite/Platform/Workers/Databases.php
rename to src/Appwrite/Platform/Modules/Databases/Workers/Databases.php
index 8c6f6f0252..7e5e9eb19f 100644
--- a/src/Appwrite/Platform/Workers/Databases.php
+++ b/src/Appwrite/Platform/Modules/Databases/Workers/Databases.php
@@ -1,6 +1,6 @@
inject('dbForProject')
->inject('queueForRealtime')
->inject('log')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
/**
@@ -60,10 +60,18 @@ class Databases extends Action
}
$type = $payload['type'];
- $collection = new Document($payload['collection'] ?? []);
- $document = new Document($payload['document'] ?? []);
+ $document = new Document($payload['row'] ?? $payload['document'] ?? []);
+ $collection = new Document($payload['table'] ?? $payload['collection'] ?? []);
$database = new Document($payload['database'] ?? []);
+ Console::info("Processing database operation: \n" . \json_encode([
+ 'type' => $type,
+ 'projectId' => $project->getId(),
+ 'databaseId' => $database->getId(),
+ 'collectionId' => $collection->getId(),
+ 'documentId' => $document->getId(),
+ ], JSON_PRETTY_PRINT));
+
$log->addTag('projectId', $project->getId());
$log->addTag('type', $type);
@@ -74,14 +82,22 @@ class Databases extends Action
$log->addTag('databaseId', $database->getId());
match (\strval($type)) {
- DATABASE_TYPE_DELETE_DATABASE => $this->deleteDatabase($database, $project, $dbForProject),
- DATABASE_TYPE_DELETE_COLLECTION => $this->deleteCollection($database, $collection, $project, $dbForProject),
+ DATABASE_TYPE_DELETE_DATABASE => $this->deleteDatabase($database, $dbForProject),
+ DATABASE_TYPE_DELETE_COLLECTION => $this->deleteCollection($database, $collection, $dbForProject),
DATABASE_TYPE_CREATE_ATTRIBUTE => $this->createAttribute($database, $collection, $document, $project, $dbForPlatform, $dbForProject, $queueForRealtime),
DATABASE_TYPE_DELETE_ATTRIBUTE => $this->deleteAttribute($database, $collection, $document, $project, $dbForPlatform, $dbForProject, $queueForRealtime),
DATABASE_TYPE_CREATE_INDEX => $this->createIndex($database, $collection, $document, $project, $dbForPlatform, $dbForProject, $queueForRealtime),
DATABASE_TYPE_DELETE_INDEX => $this->deleteIndex($database, $collection, $document, $project, $dbForPlatform, $dbForProject, $queueForRealtime),
default => throw new Exception('No database operation for type: ' . \strval($type)),
};
+
+ Console::info("Finished processing database operation: \n" . \json_encode([
+ 'type' => $type,
+ 'projectId' => $project->getId(),
+ 'databaseId' => $database->getId(),
+ 'collectionId' => $collection->getId(),
+ 'documentId' => $document->getId(),
+ ], JSON_PRETTY_PRINT));
}
/**
@@ -108,17 +124,18 @@ class Databases extends Action
Realtime $queueForRealtime
): void {
if ($collection->isEmpty()) {
- throw new Exception('Missing collection');
+ throw new Exception('Missing collection/table');
}
if ($attribute->isEmpty()) {
- throw new Exception('Missing attribute');
+ throw new Exception('Missing attribute/column');
}
$projectId = $project->getId();
$event = "databases.[databaseId].collections.[collectionId].attributes.[attributeId].update";
+
/**
* TODO @christyjacob4 verify if this is still the case
- * Fetch attribute from the database, since with Resque float values are loosing informations.
+ * Fetch attribute from the database, since with Resque float values are loosing information.
*/
$attribute = $dbForProject->getDocument('attributes', $attribute->getId());
@@ -149,7 +166,7 @@ class Databases extends Action
case Database::VAR_RELATIONSHIP:
$relatedCollection = $dbForProject->getDocument('database_' . $database->getSequence(), $options['relatedCollection']);
if ($relatedCollection->isEmpty()) {
- throw new DatabaseException('Collection not found');
+ throw new DatabaseException('Collection/Table not found');
}
if (
@@ -163,7 +180,7 @@ class Databases extends Action
onDelete: $options['onDelete'],
)
) {
- throw new DatabaseException('Failed to create Attribute');
+ throw new DatabaseException('Failed to create attribute/column');
}
if ($options['twoWay']) {
@@ -173,7 +190,7 @@ class Databases extends Action
break;
default:
if (!$dbForProject->createAttribute('database_' . $database->getSequence() . '_collection_' . $collection->getSequence(), $key, $type, $size, $required, $default, $signed, $array, $format, $formatOptions, $filters)) {
- throw new Exception('Failed to create Attribute');
+ throw new Exception('Failed to create attribute/column');
}
}
@@ -231,10 +248,10 @@ class Databases extends Action
private function deleteAttribute(Document $database, Document $collection, Document $attribute, Document $project, Database $dbForPlatform, Database $dbForProject, Realtime $queueForRealtime): void
{
if ($collection->isEmpty()) {
- throw new Exception('Missing collection');
+ throw new Exception('Missing collection/table');
}
if ($attribute->isEmpty()) {
- throw new Exception('Missing attribute');
+ throw new Exception('Missing attribute/column');
}
$projectId = $project->getId();
@@ -259,7 +276,7 @@ class Databases extends Action
if ($options['twoWay']) {
$relatedCollection = $dbForProject->getDocument('database_' . $database->getSequence(), $options['relatedCollection']);
if ($relatedCollection->isEmpty()) {
- throw new DatabaseException('Collection not found');
+ throw new DatabaseException('Collection/Table not found');
}
$relatedAttribute = $dbForProject->getDocument('attributes', $database->getSequence() . '_' . $relatedCollection->getSequence() . '_' . $options['twoWayKey']);
}
@@ -269,7 +286,7 @@ class Databases extends Action
throw new DatabaseException('Failed to delete Relationship');
}
} elseif (!$dbForProject->deleteAttribute('database_' . $database->getSequence() . '_collection_' . $collection->getSequence(), $key)) {
- throw new DatabaseException('Failed to delete Attribute');
+ throw new DatabaseException('Failed to delete attribute/column');
}
$dbForProject->deleteDocument('attributes', $attribute->getId());
@@ -391,7 +408,7 @@ class Databases extends Action
private function createIndex(Document $database, Document $collection, Document $index, Document $project, Database $dbForPlatform, Database $dbForProject, Realtime $queueForRealtime): void
{
if ($collection->isEmpty()) {
- throw new Exception('Missing collection');
+ throw new Exception('Missing collection/table');
}
if ($index->isEmpty()) {
throw new Exception('Missing index');
@@ -448,7 +465,7 @@ class Databases extends Action
private function deleteIndex(Document $database, Document $collection, Document $index, Document $project, Database $dbForPlatform, Database $dbForProject, Realtime $queueForRealtime): void
{
if ($collection->isEmpty()) {
- throw new Exception('Missing collection');
+ throw new Exception('Missing collection/table');
}
if ($index->isEmpty()) {
throw new Exception('Missing index');
@@ -488,15 +505,14 @@ class Databases extends Action
/**
* @param Document $database
- * @param Document $project
* @param $dbForProject
* @return void
* @throws Exception
*/
- protected function deleteDatabase(Document $database, Document $project, $dbForProject): void
+ protected function deleteDatabase(Document $database, $dbForProject): void
{
- $this->deleteByGroup('database_' . $database->getSequence(), [], $dbForProject, function ($collection) use ($database, $project, $dbForProject) {
- $this->deleteCollection($database, $collection, $project, $dbForProject);
+ $this->deleteByGroup('database_' . $database->getSequence(), [], $dbForProject, function ($collection) use ($database, $dbForProject) {
+ $this->deleteCollection($database, $collection, $dbForProject);
});
$dbForProject->deleteCollection('database_' . $database->getSequence());
@@ -505,7 +521,6 @@ class Databases extends Action
/**
* @param Document $database
* @param Document $collection
- * @param Document $project
* @param Database $dbForProject
* @return void
* @throws Authorization
@@ -515,10 +530,10 @@ class Databases extends Action
* @throws Structure
* @throws Exception
*/
- protected function deleteCollection(Document $database, Document $collection, Document $project, Database $dbForProject): void
+ protected function deleteCollection(Document $database, Document $collection, Database $dbForProject): void
{
if ($collection->isEmpty()) {
- throw new Exception('Missing collection');
+ throw new Exception('Missing collection/table');
}
$collectionId = $collection->getId();
@@ -578,29 +593,31 @@ class Databases extends Action
);
} catch (\Throwable $th) {
$tenant = $database->getSharedTables() ? 'Tenant:'.$database->getTenant() : '';
- Console::error("Failed to delete documents for collection:{$database->getNamespace()}_{$collectionId} {$tenant} :{$th->getMessage()}");
+ Console::error("Failed to delete documents/rows for collection/table: {$database->getNamespace()}_{$collectionId} {$tenant} :{$th->getMessage()}");
return;
}
$end = \microtime(true);
- Console::info("Deleted {$count} documents by group in " . ($end - $start) . " seconds");
+ Console::info("Deleted {$count} documents/rows by group in " . ($end - $start) . " seconds");
}
/**
* @param Document $database
* @param Document $collection
* @param Document $project
+ * @param string $event
* @param Realtime $queueForRealtime
* @param Document|null $attribute
* @param Document|null $index
* @return void
+ * @throws DatabaseException
*/
protected function trigger(
- Document $database,
- Document $collection,
- Document $project,
- string $event,
- Realtime $queueForRealtime,
+ Document $database,
+ Document $collection,
+ Document $project,
+ string $event,
+ Realtime $queueForRealtime,
Document|null $attribute = null,
Document|null $index = null,
): void {
@@ -609,14 +626,16 @@ class Databases extends Action
->setSubscribers(['console'])
->setEvent($event)
->setParam('databaseId', $database->getId())
+ ->setParam('tableId', $collection->getId())
->setParam('collectionId', $collection->getId());
- if ($attribute !== null && !empty($attribute)) {
+ if (! empty($attribute)) {
$queueForRealtime
+ ->setParam('columnId', $attribute->getId())
->setParam('attributeId', $attribute->getId())
->setPayload($attribute->getArrayCopy());
}
- if ($index !== null && !empty($index)) {
+ if (! empty($index)) {
$queueForRealtime
->setParam('indexId', $index->getId())
->setPayload($index->getArrayCopy());
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Create.php b/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Create.php
index 007cea0252..f64a960507 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Create.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Create.php
@@ -87,7 +87,7 @@ class Create extends Action
->inject('deviceForLocal')
->inject('queueForBuilds')
->inject('plan')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Delete.php b/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Delete.php
index 912e12bdc1..9e314d05c6 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Delete.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Delete.php
@@ -62,7 +62,7 @@ class Delete extends Action
->inject('queueForDeletes')
->inject('queueForEvents')
->inject('deviceForFunctions')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Download/Get.php b/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Download/Get.php
index 1993db4cf5..fd22248fa3 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Download/Get.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Download/Get.php
@@ -61,7 +61,7 @@ class Get extends Action
->inject('dbForProject')
->inject('deviceForFunctions')
->inject('deviceForBuilds')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Duplicate/Create.php b/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Duplicate/Create.php
index 0a07440dff..28861f71f1 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Duplicate/Create.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Duplicate/Create.php
@@ -62,7 +62,7 @@ class Create extends Action
->inject('queueForEvents')
->inject('queueForBuilds')
->inject('deviceForFunctions')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Get.php b/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Get.php
index e9c5240f5c..a79da7f908 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Get.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Get.php
@@ -49,7 +49,7 @@ class Get extends Action
->param('deploymentId', '', new UID(), 'Deployment ID.')
->inject('response')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Status/Update.php b/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Status/Update.php
index 4c924a64d1..e6b45b27de 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Status/Update.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Status/Update.php
@@ -59,7 +59,7 @@ class Update extends Action
->inject('project')
->inject('queueForEvents')
->inject('executor')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Template/Create.php b/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Template/Create.php
index f1bd4b71e4..4d93c8e8cd 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Template/Create.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Template/Create.php
@@ -75,7 +75,7 @@ class Create extends Base
->inject('project')
->inject('queueForBuilds')
->inject('gitHub')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Vcs/Create.php b/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Vcs/Create.php
index 48f3894bb2..0ad9852722 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Vcs/Create.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Deployments/Vcs/Create.php
@@ -72,7 +72,7 @@ class Create extends Base
->inject('queueForEvents')
->inject('queueForBuilds')
->inject('gitHub')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Deployments/XList.php b/src/Appwrite/Platform/Modules/Functions/Http/Deployments/XList.php
index 2ffcfc5d11..996df299d0 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Deployments/XList.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Deployments/XList.php
@@ -57,7 +57,7 @@ class XList extends Action
->param('search', '', new Text(256), 'Search term to filter your list results. Max length: 256 chars.', true)
->inject('response')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Executions/Create.php b/src/Appwrite/Platform/Modules/Functions/Http/Executions/Create.php
index bbdbf8ab45..d502a78e07 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Executions/Create.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Executions/Create.php
@@ -94,7 +94,7 @@ class Create extends Base
->inject('queueForFunctions')
->inject('geodb')
->inject('executor')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Executions/Delete.php b/src/Appwrite/Platform/Modules/Functions/Http/Executions/Delete.php
index 8a3d5f2a49..9c818cfacc 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Executions/Delete.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Executions/Delete.php
@@ -62,7 +62,7 @@ class Delete extends Base
->inject('dbForProject')
->inject('dbForPlatform')
->inject('queueForEvents')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Executions/Get.php b/src/Appwrite/Platform/Modules/Functions/Http/Executions/Get.php
index 659682ab55..42d78f8ca8 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Executions/Get.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Executions/Get.php
@@ -52,7 +52,7 @@ class Get extends Base
->param('executionId', '', new UID(), 'Execution ID.')
->inject('response')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Executions/XList.php b/src/Appwrite/Platform/Modules/Functions/Http/Executions/XList.php
index 91683c915b..46a41e6517 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Executions/XList.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Executions/XList.php
@@ -58,7 +58,7 @@ class XList extends Base
->param('queries', [], new Executions(), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long. You may filter on the following attributes: ' . implode(', ', Executions::ALLOWED_ATTRIBUTES), true)
->inject('response')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Functions/Create.php b/src/Appwrite/Platform/Modules/Functions/Http/Functions/Create.php
index c644c681d8..21a74f9a81 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Functions/Create.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Functions/Create.php
@@ -114,7 +114,7 @@ class Create extends Base
->inject('dbForPlatform')
->inject('request')
->inject('gitHub')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Functions/Delete.php b/src/Appwrite/Platform/Modules/Functions/Http/Functions/Delete.php
index 91da68538c..72d5589252 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Functions/Delete.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Functions/Delete.php
@@ -61,7 +61,7 @@ class Delete extends Base
->inject('queueForDeletes')
->inject('queueForEvents')
->inject('dbForPlatform')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Functions/Deployment/Update.php b/src/Appwrite/Platform/Modules/Functions/Http/Functions/Deployment/Update.php
index 23e2fc3b91..8846329d27 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Functions/Deployment/Update.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Functions/Deployment/Update.php
@@ -62,7 +62,7 @@ class Update extends Base
->inject('dbForProject')
->inject('queueForEvents')
->inject('dbForPlatform')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Functions/Get.php b/src/Appwrite/Platform/Modules/Functions/Http/Functions/Get.php
index 9ce6560fd0..e8da162b8a 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Functions/Get.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Functions/Get.php
@@ -49,7 +49,7 @@ class Get extends Base
->param('functionId', '', new UID(), 'Function ID.')
->inject('response')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Functions/Update.php b/src/Appwrite/Platform/Modules/Functions/Http/Functions/Update.php
index 2bfe8b1344..aaff953af0 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Functions/Update.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Functions/Update.php
@@ -104,7 +104,7 @@ class Update extends Base
->inject('dbForPlatform')
->inject('gitHub')
->inject('executor')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Functions/XList.php b/src/Appwrite/Platform/Modules/Functions/Http/Functions/XList.php
index cd0eba2c50..4b03a5b6cc 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Functions/XList.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Functions/XList.php
@@ -56,7 +56,7 @@ class XList extends Base
->param('search', '', new Text(256), 'Search term to filter your list results. Max length: 256 chars.', true)
->inject('response')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Runtimes/XList.php b/src/Appwrite/Platform/Modules/Functions/Http/Runtimes/XList.php
index bfccff0479..0690d1a139 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Runtimes/XList.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Runtimes/XList.php
@@ -47,7 +47,7 @@ class XList extends Base
]
))
->inject('response')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(Response $response)
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Specifications/XList.php b/src/Appwrite/Platform/Modules/Functions/Http/Specifications/XList.php
index 39186e7ab7..4c059b09d0 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Specifications/XList.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Specifications/XList.php
@@ -48,7 +48,7 @@ class XList extends Base
))
->inject('response')
->inject('plan')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(Response $response, array $plan)
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Templates/Get.php b/src/Appwrite/Platform/Modules/Functions/Http/Templates/Get.php
index 237898f6fa..f66322839b 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Templates/Get.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Templates/Get.php
@@ -49,7 +49,7 @@ class Get extends Base
))
->param('templateId', '', new Text(128), 'Template ID.')
->inject('response')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $templateId, Response $response)
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Templates/XList.php b/src/Appwrite/Platform/Modules/Functions/Http/Templates/XList.php
index 05b54a75d0..86e7f21362 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Templates/XList.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Templates/XList.php
@@ -53,7 +53,7 @@ class XList extends Base
->param('limit', 25, new Range(1, 5000), 'Limit the number of templates returned in the response. Default limit is 25, and maximum limit is 5000.', true)
->param('offset', 0, new Range(0, 5000), 'Offset the list of returned templates. Maximum offset is 5000.', true)
->inject('response')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(array $runtimes, array $usecases, int $limit, int $offset, Response $response)
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Usage/Get.php b/src/Appwrite/Platform/Modules/Functions/Http/Usage/Get.php
index 947da4cd37..acb6995d6f 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Usage/Get.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Usage/Get.php
@@ -55,7 +55,7 @@ class Get extends Base
->param('range', '30d', new WhiteList(['24h', '30d', '90d']), 'Date range.', true)
->inject('response')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $functionId, string $range, Response $response, Database $dbForProject)
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Usage/XList.php b/src/Appwrite/Platform/Modules/Functions/Http/Usage/XList.php
index e64fe9a600..6a4ded4db7 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Usage/XList.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Usage/XList.php
@@ -52,7 +52,7 @@ class XList extends Base
->param('range', '30d', new WhiteList(['24h', '30d', '90d']), 'Date range.', true)
->inject('response')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $range, Response $response, Database $dbForProject)
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Variables/Create.php b/src/Appwrite/Platform/Modules/Functions/Http/Variables/Create.php
index ee892fe1ed..815d364dad 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Variables/Create.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Variables/Create.php
@@ -65,7 +65,7 @@ class Create extends Base
->inject('dbForProject')
->inject('dbForPlatform')
->inject('project')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Variables/Delete.php b/src/Appwrite/Platform/Modules/Functions/Http/Variables/Delete.php
index dda1f97f6b..35f9618edb 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Variables/Delete.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Variables/Delete.php
@@ -57,7 +57,7 @@ class Delete extends Base
->inject('response')
->inject('dbForProject')
->inject('dbForPlatform')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Variables/Get.php b/src/Appwrite/Platform/Modules/Functions/Http/Variables/Get.php
index 98119c4a66..3955b854e9 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Variables/Get.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Variables/Get.php
@@ -53,7 +53,7 @@ class Get extends Base
->param('variableId', '', new UID(), 'Variable unique ID.', false)
->inject('response')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $functionId, string $variableId, Response $response, Database $dbForProject)
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Variables/Update.php b/src/Appwrite/Platform/Modules/Functions/Http/Variables/Update.php
index 7a6acf88e3..639b1c74d5 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Variables/Update.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Variables/Update.php
@@ -61,7 +61,7 @@ class Update extends Base
->inject('response')
->inject('dbForProject')
->inject('dbForPlatform')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Functions/Http/Variables/XList.php b/src/Appwrite/Platform/Modules/Functions/Http/Variables/XList.php
index 9c02cfe07c..29465b7572 100644
--- a/src/Appwrite/Platform/Modules/Functions/Http/Variables/XList.php
+++ b/src/Appwrite/Platform/Modules/Functions/Http/Variables/XList.php
@@ -53,7 +53,7 @@ class XList extends Base
->param('functionId', '', new UID(), 'Function unique ID.', false)
->inject('response')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $functionId, Response $response, Database $dbForProject)
diff --git a/src/Appwrite/Platform/Modules/Functions/Workers/Builds.php b/src/Appwrite/Platform/Modules/Functions/Workers/Builds.php
index bbe1e1f004..25b3473829 100644
--- a/src/Appwrite/Platform/Modules/Functions/Workers/Builds.php
+++ b/src/Appwrite/Platform/Modules/Functions/Workers/Builds.php
@@ -75,7 +75,7 @@ class Builds extends Action
->inject('log')
->inject('executor')
->inject('plan')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
/**
@@ -209,6 +209,9 @@ class Builds extends Action
Executor $executor,
array $plan
): void {
+ $startTime = DateTime::now();
+ $durationStart = \microtime(true);
+
$resourceKey = match ($resource->getCollection()) {
'functions' => 'functionId',
'sites' => 'siteId',
@@ -260,9 +263,6 @@ class Builds extends Action
->setParam($resourceKey, $resource->getId())
->setParam('deploymentId', $deployment->getId());
- $startTime = DateTime::now();
- $durationStart = \microtime(true);
-
if ($deployment->getAttribute('status') === 'canceled') {
Console::info('Build has been canceled');
return;
@@ -445,7 +445,7 @@ class Builds extends Action
Console::execute('rsync -av --exclude \'.git\' ' . \escapeshellarg($tmpTemplateDirectory . '/' . $templateRootDirectory . '/') . ' ' . \escapeshellarg($tmpDirectory . '/' . $rootDirectory), '', $stdout, $stderr);
// Commit and push
- $exit = Console::execute('git config --global user.email "team@appwrite.io" && git config --global user.name "Appwrite" && cd ' . \escapeshellarg($tmpDirectory) . ' && git add . && git commit -m "Create ' . \escapeshellarg($resource->getAttribute('name', '')) . ' function" && git push origin ' . \escapeshellarg($branchName), '', $stdout, $stderr);
+ $exit = Console::execute('git config --global user.email "team@appwrite.io" && git config --global user.name "Appwrite" && cd ' . \escapeshellarg($tmpDirectory) . ' && git checkout -b ' . \escapeshellarg($branchName) . ' && git add . && git commit -m "Create ' . \escapeshellarg($resource->getAttribute('name', '')) . ' function" && git push origin ' . \escapeshellarg($branchName), '', $stdout, $stderr);
if ($exit !== 0) {
throw new \Exception('Unable to push code repository: ' . $stderr);
@@ -747,6 +747,13 @@ class Builds extends Action
if ($separator !== false) {
$logs = \substr($logs, 0, $separator);
$insideSeparation = true;
+
+ $leftover = \substr($logs, $separator + strlen('{APPWRITE_DETECTION_SEPARATOR_START}'));
+ $separator = \strpos($leftover, '{APPWRITE_DETECTION_SEPARATOR_END}');
+ if ($separator !== false) {
+ $logs .= \substr($leftover, $separator + strlen('{APPWRITE_DETECTION_SEPARATOR_END}'));
+ $insideSeparation = false;
+ }
}
} else {
$separator = \strpos($logs, '{APPWRITE_DETECTION_SEPARATOR_END}');
@@ -810,9 +817,6 @@ class Builds extends Action
throw $err;
}
- $endTime = DateTime::now();
- $durationEnd = \microtime(true);
-
$buildSizeLimit = (int)System::getEnv('_APP_COMPUTE_BUILD_SIZE_LIMIT', '2000000000');
if (isset($plan['buildSize'])) {
$buildSizeLimit = $plan['buildSize'] * 1000 * 1000;
@@ -821,10 +825,6 @@ class Builds extends Action
throw new \Exception('Build size should be less than ' . number_format($buildSizeLimit / (1000 * 1000), 2) . ' MBs.');
}
- /** Update the build document */
- $deployment->setAttribute('buildStartedAt', DateTime::format((new \DateTime())->setTimestamp(floor($response['startTime']))));
- $deployment->setAttribute('buildEndedAt', $endTime);
- $deployment->setAttribute('buildDuration', \intval(\ceil($durationEnd - $durationStart)));
$deployment->setAttribute('buildPath', $response['path']);
$deployment->setAttribute('buildSize', $response['size']);
$deployment->setAttribute('totalSize', $deployment->getAttribute('buildSize', 0) + $deployment->getAttribute('sourceSize', 0));
@@ -836,18 +836,10 @@ class Builds extends Action
// Separate logs for SSR detection
$detectionLogs = '';
- $separator = \strpos($logs, '{APPWRITE_DETECTION_SEPARATOR_START}');
- if ($separator !== false) {
- $detectionLogs = \substr($logs, $separator + strlen('{APPWRITE_DETECTION_SEPARATOR}'));
- $separatorEnd = \strpos($detectionLogs, '{APPWRITE_DETECTION_SEPARATOR_END}');
- $logs .= \substr($detectionLogs, $separatorEnd + strlen('{APPWRITE_DETECTION_SEPARATOR_END}'));
- $detectionLogs = \substr($detectionLogs, 0, $separatorEnd);
- $logs = \substr($logs, 0, $separator);
- }
-
- if ($resource->getCollection() === 'sites') {
- $date = \date('H:i:s');
- $logs .= "[90m[$date] [90m[[0mappwrite[90m][97m Screenshot capturing started. [0m\n";
+ if (\str_contains($logs, '{APPWRITE_DETECTION_SEPARATOR_START}')) {
+ [$logsBefore, $detectionLogsStart] = \explode('{APPWRITE_DETECTION_SEPARATOR_START}', $logs, 2);
+ [$detectionLogs, $logsAfter] = \explode('{APPWRITE_DETECTION_SEPARATOR_END}', $detectionLogsStart, 2);
+ $logs = ($logsBefore ?? '') . ($logsAfter ?? '');
}
$deployment->setAttribute('buildLogs', $logs);
@@ -877,16 +869,24 @@ class Builds extends Action
}
}
- $deployment->setAttribute('buildLogs', $logs);
-
- $this->afterBuildSuccess($dbForProject, $deployment);
-
$deployment = $dbForProject->updateDocument('deployments', $deployment->getId(), $deployment);
-
$queueForRealtime
->setPayload($deployment->getArrayCopy())
->trigger();
+ $this->afterBuildSuccess($queueForRealtime, $dbForProject, $deployment);
+ $logs = $deployment->getAttribute('buildLogs', '');
+
+ if ($resource->getCollection() === 'sites') {
+ $date = \date('H:i:s');
+ $logs .= "[90m[$date] [90m[[0mappwrite[90m][97m Screenshot capturing started. [0m\n";
+ $deployment->setAttribute('buildLogs', $logs);
+ $deployment = $dbForProject->updateDocument('deployments', $deployment->getId(), $deployment);
+ $queueForRealtime
+ ->setPayload($deployment->getArrayCopy())
+ ->trigger();
+ }
+
/** Screenshot site */
if ($resource->getCollection() === 'sites') {
try {
@@ -1032,6 +1032,7 @@ class Builds extends Action
$date = \date('H:i:s');
$logs .= "[90m[$date] [90m[[0mappwrite[90m][97m Screenshot capturing finished. [0m\n";
+ $deployment->setAttribute('buildLogs', $logs);
$deployment = $dbForProject->updateDocument('deployments', $deployment->getId(), $deployment);
$queueForRealtime
@@ -1046,6 +1047,7 @@ class Builds extends Action
$date = \date('H:i:s');
$logs .= "[90m[$date] [90m[[0mappwrite[90m][33m Screenshot capturing failed. Deployment will continue. [0m\n";
+ $deployment->setAttribute('buildLogs', $logs);
$deployment = $dbForProject->updateDocument('deployments', $deployment->getId(), $deployment);
}
}
@@ -1189,6 +1191,15 @@ class Builds extends Action
}
}
+ $endTime = DateTime::now();
+ $durationEnd = \microtime(true);
+ $deployment->setAttribute('buildEndedAt', $endTime);
+ $deployment->setAttribute('buildDuration', \intval(\ceil($durationEnd - $durationStart)));
+ $deployment = $dbForProject->updateDocument('deployments', $deployment->getId(), $deployment);
+ $queueForRealtime
+ ->setPayload($deployment->getArrayCopy())
+ ->trigger();
+
if ($dbForProject->getDocument('deployments', $deploymentId)->getAttribute('status') === 'canceled') {
Console::info('Build has been canceled');
return;
@@ -1223,16 +1234,12 @@ class Builds extends Action
$message = "[31m" . $message;
}
- $separator = \strpos($message, '{APPWRITE_DETECTION_SEPARATOR_START}');
- if ($separator !== false) {
- $error = \substr($message, $separator + strlen('{APPWRITE_DETECTION_SEPARATOR_START}'));
- $message = \substr($message, 0, $separator);
- $message .= "\n[31m" . $error;
- }
+ $message = \str_replace('{APPWRITE_DETECTION_SEPARATOR_START}', '', $message);
+ $message = \str_replace('{APPWRITE_DETECTION_SEPARATOR_END}', '', $message);
// Combine with previous logs if deployment got past build process
$previousLogs = '';
- if (!empty($deployment->getAttribute('buildEndedAt', ''))) {
+ if (!is_null($deployment->getAttribute('buildSize', null))) {
$previousLogs = $deployment->getAttribute('buildLogs', '');
if (!empty($previousLogs)) {
$message = $previousLogs . "\n" . $message;
@@ -1317,12 +1324,14 @@ class Builds extends Action
/**
* Hook to run after build success
*
+ * @param Realtime $queueForRealtime
* @param Database $dbForProject
* @param Document $deployment
* @return void
*/
- protected function afterBuildSuccess(Database $dbForProject, Document &$deployment): void
+ protected function afterBuildSuccess(Realtime $queueForRealtime, Database $dbForProject, Document &$deployment): void
{
+ assert($queueForRealtime instanceof Realtime);
assert($dbForProject instanceof Database);
assert($deployment instanceof Document);
}
@@ -1438,7 +1447,7 @@ class Builds extends Action
$name = "{$resourceName} ({$projectName})";
$protocol = System::getEnv('_APP_OPTIONS_FORCE_HTTPS') == 'disabled' ? 'http' : 'https';
- $hostname = System::getEnv('_APP_DOMAIN');
+ $hostname = System::getEnv('_APP_CONSOLE_DOMAIN', System::getEnv('_APP_DOMAIN', ''));
$projectId = $project->getId();
$region = $project->getAttribute('region', 'default');
diff --git a/src/Appwrite/Platform/Modules/Projects/Http/DevKeys/Create.php b/src/Appwrite/Platform/Modules/Projects/Http/DevKeys/Create.php
index 54ff189c20..9332453eea 100644
--- a/src/Appwrite/Platform/Modules/Projects/Http/DevKeys/Create.php
+++ b/src/Appwrite/Platform/Modules/Projects/Http/DevKeys/Create.php
@@ -57,7 +57,7 @@ class Create extends Action
->inject('user')
->inject('response')
->inject('dbForPlatform')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $projectId, string $name, ?string $expire, Document $user, Response $response, Database $dbForPlatform)
diff --git a/src/Appwrite/Platform/Modules/Projects/Http/DevKeys/Delete.php b/src/Appwrite/Platform/Modules/Projects/Http/DevKeys/Delete.php
index eac42be5f0..2bfea6c55b 100644
--- a/src/Appwrite/Platform/Modules/Projects/Http/DevKeys/Delete.php
+++ b/src/Appwrite/Platform/Modules/Projects/Http/DevKeys/Delete.php
@@ -49,7 +49,7 @@ class Delete extends Action
->param('keyId', '', new UID(), 'Key unique ID.')
->inject('response')
->inject('dbForPlatform')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $projectId, string $keyId, Response $response, Database $dbForPlatform)
diff --git a/src/Appwrite/Platform/Modules/Projects/Http/DevKeys/Get.php b/src/Appwrite/Platform/Modules/Projects/Http/DevKeys/Get.php
index 6255976de4..29cda90f66 100644
--- a/src/Appwrite/Platform/Modules/Projects/Http/DevKeys/Get.php
+++ b/src/Appwrite/Platform/Modules/Projects/Http/DevKeys/Get.php
@@ -49,7 +49,7 @@ class Get extends Action
->param('keyId', '', new UID(), 'Key unique ID.')
->inject('response')
->inject('dbForPlatform')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $projectId, string $keyId, Response $response, Database $dbForPlatform)
diff --git a/src/Appwrite/Platform/Modules/Projects/Http/DevKeys/Update.php b/src/Appwrite/Platform/Modules/Projects/Http/DevKeys/Update.php
index 33b91eb0b6..b13bc535dd 100644
--- a/src/Appwrite/Platform/Modules/Projects/Http/DevKeys/Update.php
+++ b/src/Appwrite/Platform/Modules/Projects/Http/DevKeys/Update.php
@@ -52,7 +52,7 @@ class Update extends Action
->param('expire', null, new DatetimeValidator(), 'Expiration time in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.')
->inject('response')
->inject('dbForPlatform')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $projectId, string $keyId, string $name, ?string $expire, Response $response, Database $dbForPlatform)
{
diff --git a/src/Appwrite/Platform/Modules/Projects/Http/DevKeys/XList.php b/src/Appwrite/Platform/Modules/Projects/Http/DevKeys/XList.php
index 73e79a783a..209387018b 100644
--- a/src/Appwrite/Platform/Modules/Projects/Http/DevKeys/XList.php
+++ b/src/Appwrite/Platform/Modules/Projects/Http/DevKeys/XList.php
@@ -53,7 +53,7 @@ class XList extends Action
->param('queries', [], new DevKeys(), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long. You may filter on the following attributes: ' . implode(', ', DevKeys::ALLOWED_ATTRIBUTES), true)
->inject('response')
->inject('dbForPlatform')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $projectId, ?array $queries, Response $response, Database $dbForPlatform)
diff --git a/src/Appwrite/Platform/Modules/Proxy/Http/Rules/API/Create.php b/src/Appwrite/Platform/Modules/Proxy/Http/Rules/API/Create.php
index 33eb5313a0..4efe8176f6 100644
--- a/src/Appwrite/Platform/Modules/Proxy/Http/Rules/API/Create.php
+++ b/src/Appwrite/Platform/Modules/Proxy/Http/Rules/API/Create.php
@@ -66,7 +66,7 @@ class Create extends Action
->inject('queueForCertificates')
->inject('queueForEvents')
->inject('dbForPlatform')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $domain, Response $response, Document $project, Certificate $queueForCertificates, Event $queueForEvents, Database $dbForPlatform)
diff --git a/src/Appwrite/Platform/Modules/Proxy/Http/Rules/Function/Create.php b/src/Appwrite/Platform/Modules/Proxy/Http/Rules/Function/Create.php
index 0b68b80aa3..1c8fe7b04d 100644
--- a/src/Appwrite/Platform/Modules/Proxy/Http/Rules/Function/Create.php
+++ b/src/Appwrite/Platform/Modules/Proxy/Http/Rules/Function/Create.php
@@ -71,7 +71,7 @@ class Create extends Action
->inject('queueForEvents')
->inject('dbForPlatform')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $domain, string $functionId, string $branch, Response $response, Document $project, Certificate $queueForCertificates, Event $queueForEvents, Database $dbForPlatform, Database $dbForProject)
diff --git a/src/Appwrite/Platform/Modules/Proxy/Http/Rules/Redirect/Create.php b/src/Appwrite/Platform/Modules/Proxy/Http/Rules/Redirect/Create.php
index 60e8759e5c..580d92bc74 100644
--- a/src/Appwrite/Platform/Modules/Proxy/Http/Rules/Redirect/Create.php
+++ b/src/Appwrite/Platform/Modules/Proxy/Http/Rules/Redirect/Create.php
@@ -74,7 +74,7 @@ class Create extends Action
->inject('queueForEvents')
->inject('dbForPlatform')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $domain, string $url, int $statusCode, string $resourceId, string $resourceType, Response $response, Document $project, Certificate $queueForCertificates, Event $queueForEvents, Database $dbForPlatform, Database $dbForProject)
diff --git a/src/Appwrite/Platform/Modules/Proxy/Http/Rules/Site/Create.php b/src/Appwrite/Platform/Modules/Proxy/Http/Rules/Site/Create.php
index 7c2a640cdf..7a5a1f4952 100644
--- a/src/Appwrite/Platform/Modules/Proxy/Http/Rules/Site/Create.php
+++ b/src/Appwrite/Platform/Modules/Proxy/Http/Rules/Site/Create.php
@@ -71,7 +71,7 @@ class Create extends Action
->inject('queueForEvents')
->inject('dbForPlatform')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $domain, string $siteId, string $branch, Response $response, Document $project, Certificate $queueForCertificates, Event $queueForEvents, Database $dbForPlatform, Database $dbForProject)
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Create.php b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Create.php
index 62c5998c9b..65a0fcf143 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Create.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Create.php
@@ -86,7 +86,7 @@ class Create extends Action
->inject('deviceForLocal')
->inject('queueForBuilds')
->inject('plan')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Delete.php b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Delete.php
index 8717d04fc2..dfc0f0c976 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Delete.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Delete.php
@@ -62,7 +62,7 @@ class Delete extends Action
->inject('queueForDeletes')
->inject('queueForEvents')
->inject('deviceForSites')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Download/Get.php b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Download/Get.php
index d3a2f0b814..5a87ce453f 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Download/Get.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Download/Get.php
@@ -60,7 +60,7 @@ class Get extends Action
->inject('dbForProject')
->inject('deviceForSites')
->inject('deviceForBuilds')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Duplicate/Create.php b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Duplicate/Create.php
index 739c701a2e..22a7a47390 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Duplicate/Create.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Duplicate/Create.php
@@ -65,7 +65,7 @@ class Create extends Action
->inject('queueForEvents')
->inject('queueForBuilds')
->inject('deviceForSites')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Get.php b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Get.php
index d280231159..d583c62fb1 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Get.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Get.php
@@ -49,7 +49,7 @@ class Get extends Action
->param('deploymentId', '', new UID(), 'Deployment ID.')
->inject('response')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $siteId, string $deploymentId, Response $response, Database $dbForProject)
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Status/Update.php b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Status/Update.php
index 046ddd1ac8..a447e54f8d 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Status/Update.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Status/Update.php
@@ -57,7 +57,7 @@ class Update extends Action
->inject('project')
->inject('queueForEvents')
->inject('executor')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Template/Create.php b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Template/Create.php
index 5de688fbf8..a2040d830b 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Template/Create.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Template/Create.php
@@ -77,7 +77,7 @@ class Create extends Base
->inject('queueForEvents')
->inject('queueForBuilds')
->inject('gitHub')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Vcs/Create.php b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Vcs/Create.php
index eb6fdf4094..ddad5d793a 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Vcs/Create.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/Vcs/Create.php
@@ -72,7 +72,7 @@ class Create extends Base
->inject('queueForEvents')
->inject('queueForBuilds')
->inject('gitHub')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/XList.php b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/XList.php
index 306f756d87..a1a79ec155 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Deployments/XList.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Deployments/XList.php
@@ -57,7 +57,7 @@ class XList extends Action
->param('search', '', new Text(256), 'Search term to filter your list results. Max length: 256 chars.', true)
->inject('response')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $siteId, array $queries, string $search, Response $response, Database $dbForProject)
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Frameworks/XList.php b/src/Appwrite/Platform/Modules/Sites/Http/Frameworks/XList.php
index cf2bb8c62b..a042fd6e7c 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Frameworks/XList.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Frameworks/XList.php
@@ -46,7 +46,7 @@ class XList extends Base
]
))
->inject('response')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(Response $response)
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Logs/Delete.php b/src/Appwrite/Platform/Modules/Sites/Http/Logs/Delete.php
index 2d87321086..0f53985039 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Logs/Delete.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Logs/Delete.php
@@ -55,7 +55,7 @@ class Delete extends Base
->inject('response')
->inject('dbForProject')
->inject('queueForEvents')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $siteId, string $logId, Response $response, Database $dbForProject, Event $queueForEvents)
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Logs/Get.php b/src/Appwrite/Platform/Modules/Sites/Http/Logs/Get.php
index 2ef7d75539..935e790113 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Logs/Get.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Logs/Get.php
@@ -50,7 +50,7 @@ class Get extends Base
->param('logId', '', new UID(), 'Log ID.')
->inject('response')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $siteId, string $logId, Response $response, Database $dbForProject)
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Logs/XList.php b/src/Appwrite/Platform/Modules/Sites/Http/Logs/XList.php
index 7e2c587797..f9bee3e425 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Logs/XList.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Logs/XList.php
@@ -57,7 +57,7 @@ class XList extends Base
->param('queries', [], new Logs(), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long. You may filter on the following attributes: ' . implode(', ', Executions::ALLOWED_ATTRIBUTES), true)
->inject('response')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $siteId, array $queries, Response $response, Database $dbForProject)
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Sites/Create.php b/src/Appwrite/Platform/Modules/Sites/Http/Sites/Create.php
index 6dd1865047..9be95441cb 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Sites/Create.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Sites/Create.php
@@ -89,7 +89,7 @@ class Create extends Base
->inject('project')
->inject('queueForEvents')
->inject('dbForPlatform')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Sites/Delete.php b/src/Appwrite/Platform/Modules/Sites/Http/Sites/Delete.php
index 37666215e5..ed9b059c33 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Sites/Delete.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Sites/Delete.php
@@ -58,7 +58,7 @@ class Delete extends Base
->inject('dbForProject')
->inject('queueForDeletes')
->inject('queueForEvents')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Sites/Deployment/Update.php b/src/Appwrite/Platform/Modules/Sites/Http/Sites/Deployment/Update.php
index a45c2a1243..bb6bd4f632 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Sites/Deployment/Update.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Sites/Deployment/Update.php
@@ -60,7 +60,7 @@ class Update extends Base
->inject('dbForProject')
->inject('queueForEvents')
->inject('dbForPlatform')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Sites/Get.php b/src/Appwrite/Platform/Modules/Sites/Http/Sites/Get.php
index 88ff5f1d51..d86d98ef71 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Sites/Get.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Sites/Get.php
@@ -49,7 +49,7 @@ class Get extends Base
->param('siteId', '', new UID(), 'Site ID.')
->inject('response')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $siteId, Response $response, Database $dbForProject)
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Sites/Update.php b/src/Appwrite/Platform/Modules/Sites/Http/Sites/Update.php
index 85f1ee8845..80354d5067 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Sites/Update.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Sites/Update.php
@@ -97,7 +97,7 @@ class Update extends Base
->inject('dbForPlatform')
->inject('gitHub')
->inject('executor')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Sites/XList.php b/src/Appwrite/Platform/Modules/Sites/Http/Sites/XList.php
index 0a3b257f59..988a2d2e20 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Sites/XList.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Sites/XList.php
@@ -56,7 +56,7 @@ class XList extends Base
->param('search', '', new Text(256), 'Search term to filter your list results. Max length: 256 chars.', true)
->inject('response')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(array $queries, string $search, Response $response, Database $dbForProject)
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Specifications/XList.php b/src/Appwrite/Platform/Modules/Sites/Http/Specifications/XList.php
index 2a9447f8c6..a76f067114 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Specifications/XList.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Specifications/XList.php
@@ -48,7 +48,7 @@ class XList extends Base
))
->inject('response')
->inject('plan')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(Response $response, array $plan)
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Templates/Get.php b/src/Appwrite/Platform/Modules/Sites/Http/Templates/Get.php
index a4066fb787..633ef31e68 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Templates/Get.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Templates/Get.php
@@ -49,7 +49,7 @@ class Get extends Base
))
->param('templateId', '', new Text(128), 'Template ID.')
->inject('response')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $templateId, Response $response)
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Templates/XList.php b/src/Appwrite/Platform/Modules/Sites/Http/Templates/XList.php
index 414ecc9987..4fe00f3edf 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Templates/XList.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Templates/XList.php
@@ -53,7 +53,7 @@ class XList extends Base
->param('limit', 25, new Range(1, 5000), 'Limit the number of templates returned in the response. Default limit is 25, and maximum limit is 5000.', true)
->param('offset', 0, new Range(0, 5000), 'Offset the list of returned templates. Maximum offset is 5000.', true)
->inject('response')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Usage/Get.php b/src/Appwrite/Platform/Modules/Sites/Http/Usage/Get.php
index f8df836085..af96c10457 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Usage/Get.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Usage/Get.php
@@ -55,7 +55,7 @@ class Get extends Base
->param('range', '30d', new WhiteList(['24h', '30d', '90d']), 'Date range.', true)
->inject('response')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Usage/XList.php b/src/Appwrite/Platform/Modules/Sites/Http/Usage/XList.php
index e37d3e792e..d36cc56ae5 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Usage/XList.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Usage/XList.php
@@ -52,7 +52,7 @@ class XList extends Base
->param('range', '30d', new WhiteList(['24h', '30d', '90d']), 'Date range.', true)
->inject('response')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $range, Response $response, Database $dbForProject)
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Variables/Create.php b/src/Appwrite/Platform/Modules/Sites/Http/Variables/Create.php
index 88da635fe4..ef504fe663 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Variables/Create.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Variables/Create.php
@@ -62,7 +62,7 @@ class Create extends Base
->inject('response')
->inject('dbForProject')
->inject('project')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $siteId, string $key, string $value, bool $secret, Response $response, Database $dbForProject, Document $project)
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Variables/Delete.php b/src/Appwrite/Platform/Modules/Sites/Http/Variables/Delete.php
index ea927be367..be0addb34c 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Variables/Delete.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Variables/Delete.php
@@ -54,7 +54,7 @@ class Delete extends Base
->param('variableId', '', new UID(), 'Variable unique ID.', false)
->inject('response')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $siteId, string $variableId, Response $response, Database $dbForProject)
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Variables/Get.php b/src/Appwrite/Platform/Modules/Sites/Http/Variables/Get.php
index 1c25f9e701..11eb546092 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Variables/Get.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Variables/Get.php
@@ -53,7 +53,7 @@ class Get extends Base
->param('variableId', '', new UID(), 'Variable unique ID.', false)
->inject('response')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $siteId, string $variableId, Response $response, Database $dbForProject)
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Variables/Update.php b/src/Appwrite/Platform/Modules/Sites/Http/Variables/Update.php
index 698992f79f..3cf2e2f85f 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Variables/Update.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Variables/Update.php
@@ -58,7 +58,7 @@ class Update extends Base
->param('secret', null, new Boolean(), 'Secret variables can be updated or deleted, but only sites can read them during build and runtime.', true)
->inject('response')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Sites/Http/Variables/XList.php b/src/Appwrite/Platform/Modules/Sites/Http/Variables/XList.php
index 15e21296a5..51ab355c75 100644
--- a/src/Appwrite/Platform/Modules/Sites/Http/Variables/XList.php
+++ b/src/Appwrite/Platform/Modules/Sites/Http/Variables/XList.php
@@ -53,7 +53,7 @@ class XList extends Base
->param('siteId', '', new UID(), 'Site unique ID.', false)
->inject('response')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Modules/Tokens/Http/Tokens/Buckets/Files/Create.php b/src/Appwrite/Platform/Modules/Tokens/Http/Tokens/Buckets/Files/Create.php
index dc1e5232b6..fe7a0187e9 100644
--- a/src/Appwrite/Platform/Modules/Tokens/Http/Tokens/Buckets/Files/Create.php
+++ b/src/Appwrite/Platform/Modules/Tokens/Http/Tokens/Buckets/Files/Create.php
@@ -65,7 +65,7 @@ class Create extends Action
->inject('response')
->inject('dbForProject')
->inject('queueForEvents')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $bucketId, string $fileId, ?string $expire, Response $response, Database $dbForProject, Event $queueForEvents): void
diff --git a/src/Appwrite/Platform/Modules/Tokens/Http/Tokens/Buckets/Files/XList.php b/src/Appwrite/Platform/Modules/Tokens/Http/Tokens/Buckets/Files/XList.php
index 628d9b768f..231164d6ee 100644
--- a/src/Appwrite/Platform/Modules/Tokens/Http/Tokens/Buckets/Files/XList.php
+++ b/src/Appwrite/Platform/Modules/Tokens/Http/Tokens/Buckets/Files/XList.php
@@ -55,7 +55,7 @@ class XList extends Action
->param('queries', [], new FileTokens(), 'Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of ' . APP_LIMIT_ARRAY_PARAMS_SIZE . ' queries are allowed, each ' . APP_LIMIT_ARRAY_ELEMENT_SIZE . ' characters long. You may filter on the following attributes: ' . implode(', ', FileTokens::ALLOWED_ATTRIBUTES), true)
->inject('response')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $bucketId, string $fileId, array $queries, Response $response, Database $dbForProject)
diff --git a/src/Appwrite/Platform/Modules/Tokens/Http/Tokens/Delete.php b/src/Appwrite/Platform/Modules/Tokens/Http/Tokens/Delete.php
index fcac9a6b24..c36df367ee 100644
--- a/src/Appwrite/Platform/Modules/Tokens/Http/Tokens/Delete.php
+++ b/src/Appwrite/Platform/Modules/Tokens/Http/Tokens/Delete.php
@@ -58,7 +58,7 @@ class Delete extends Action
->inject('response')
->inject('dbForProject')
->inject('queueForEvents')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $tokenId, Response $response, Database $dbForProject, Event $queueForEvents)
diff --git a/src/Appwrite/Platform/Modules/Tokens/Http/Tokens/Get.php b/src/Appwrite/Platform/Modules/Tokens/Http/Tokens/Get.php
index 66b9c1b5cb..4da9e125f2 100644
--- a/src/Appwrite/Platform/Modules/Tokens/Http/Tokens/Get.php
+++ b/src/Appwrite/Platform/Modules/Tokens/Http/Tokens/Get.php
@@ -50,7 +50,7 @@ class Get extends Action
->param('tokenId', '', new UID(), 'Token ID.')
->inject('response')
->inject('dbForProject')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $tokenId, Response $response, Database $dbForProject)
diff --git a/src/Appwrite/Platform/Modules/Tokens/Http/Tokens/Update.php b/src/Appwrite/Platform/Modules/Tokens/Http/Tokens/Update.php
index c341831c0d..7a15708011 100644
--- a/src/Appwrite/Platform/Modules/Tokens/Http/Tokens/Update.php
+++ b/src/Appwrite/Platform/Modules/Tokens/Http/Tokens/Update.php
@@ -61,7 +61,7 @@ class Update extends Action
->inject('response')
->inject('dbForProject')
->inject('queueForEvents')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $tokenId, ?string $expire, Response $response, Database $dbForProject, Event $queueForEvents)
diff --git a/src/Appwrite/Platform/Services/Workers.php b/src/Appwrite/Platform/Services/Workers.php
index e22f402145..f2cbeb390a 100644
--- a/src/Appwrite/Platform/Services/Workers.php
+++ b/src/Appwrite/Platform/Services/Workers.php
@@ -4,7 +4,6 @@ namespace Appwrite\Platform\Services;
use Appwrite\Platform\Workers\Audits;
use Appwrite\Platform\Workers\Certificates;
-use Appwrite\Platform\Workers\Databases;
use Appwrite\Platform\Workers\Deletes;
use Appwrite\Platform\Workers\Functions;
use Appwrite\Platform\Workers\Mails;
@@ -23,7 +22,6 @@ class Workers extends Service
$this
->addAction(Audits::getName(), new Audits())
->addAction(Certificates::getName(), new Certificates())
- ->addAction(Databases::getName(), new Databases())
->addAction(Deletes::getName(), new Deletes())
->addAction(Functions::getName(), new Functions())
->addAction(Mails::getName(), new Mails())
diff --git a/src/Appwrite/Platform/Tasks/Doctor.php b/src/Appwrite/Platform/Tasks/Doctor.php
index b543555477..20eeb0826e 100644
--- a/src/Appwrite/Platform/Tasks/Doctor.php
+++ b/src/Appwrite/Platform/Tasks/Doctor.php
@@ -34,7 +34,7 @@ class Doctor extends Action
$this
->desc('Validate server health')
->inject('register')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(Registry $register): void
diff --git a/src/Appwrite/Platform/Tasks/Install.php b/src/Appwrite/Platform/Tasks/Install.php
index c7b1f72453..c3b4e33593 100644
--- a/src/Appwrite/Platform/Tasks/Install.php
+++ b/src/Appwrite/Platform/Tasks/Install.php
@@ -31,7 +31,7 @@ class Install extends Action
->param('image', 'appwrite', new Text(0), 'Main appwrite docker image', true)
->param('interactive', 'Y', new Text(1), 'Run an interactive session', true)
->param('no-start', false, new Boolean(true), 'Run an interactive session', true)
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $httpPort, string $httpsPort, string $organization, string $image, string $interactive, bool $noStart): void
diff --git a/src/Appwrite/Platform/Tasks/Maintenance.php b/src/Appwrite/Platform/Tasks/Maintenance.php
index ddc8c3cb6f..e6def793b5 100644
--- a/src/Appwrite/Platform/Tasks/Maintenance.php
+++ b/src/Appwrite/Platform/Tasks/Maintenance.php
@@ -29,7 +29,7 @@ class Maintenance extends Action
->inject('console')
->inject('queueForCertificates')
->inject('queueForDeletes')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(Database $dbForPlatform, Document $console, Certificate $queueForCertificates, Delete $queueForDeletes): void
diff --git a/src/Appwrite/Platform/Tasks/QueueRetry.php b/src/Appwrite/Platform/Tasks/QueueRetry.php
index f8099dcb00..442fa39823 100644
--- a/src/Appwrite/Platform/Tasks/QueueRetry.php
+++ b/src/Appwrite/Platform/Tasks/QueueRetry.php
@@ -24,7 +24,7 @@ class QueueRetry extends Action
->param('name', '', new Text(100), 'Queue name')
->param('limit', 0, new Wildcard(), 'jobs limit', true)
->inject('publisher')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
/**
diff --git a/src/Appwrite/Platform/Tasks/SDKs.php b/src/Appwrite/Platform/Tasks/SDKs.php
index 07749400d6..ea73af541c 100644
--- a/src/Appwrite/Platform/Tasks/SDKs.php
+++ b/src/Appwrite/Platform/Tasks/SDKs.php
@@ -46,7 +46,7 @@ class SDKs extends Action
->param('git', null, new Nullable(new WhiteList(['yes', 'no'])), 'Should we use git push?', optional: true)
->param('production', null, new Nullable(new WhiteList(['yes', 'no'])), 'Should we push to production?', optional: true)
->param('message', null, new Nullable(new Text(256)), 'Commit Message', optional: true)
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(?string $selectedPlatform, ?string $selectedSDK, ?string $version, ?string $git, ?string $production, ?string $message): void
diff --git a/src/Appwrite/Platform/Tasks/SSL.php b/src/Appwrite/Platform/Tasks/SSL.php
index ae1c93a360..651cb4de11 100644
--- a/src/Appwrite/Platform/Tasks/SSL.php
+++ b/src/Appwrite/Platform/Tasks/SSL.php
@@ -24,7 +24,7 @@ class SSL extends Action
->param('domain', System::getEnv('_APP_DOMAIN', ''), new Hostname(), 'Domain to generate certificate for. If empty, main domain will be used.', true)
->param('skip-check', true, new Boolean(true), 'If DNS and renew check should be skipped. Defaults to true, and when true, all jobs will result in certificate generation attempt.', true)
->inject('queueForCertificates')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $domain, bool|string $skipCheck, Certificate $queueForCertificates): void
diff --git a/src/Appwrite/Platform/Tasks/ScheduleBase.php b/src/Appwrite/Platform/Tasks/ScheduleBase.php
index b2134707e7..7686815868 100644
--- a/src/Appwrite/Platform/Tasks/ScheduleBase.php
+++ b/src/Appwrite/Platform/Tasks/ScheduleBase.php
@@ -26,6 +26,7 @@ abstract class ScheduleBase extends Action
protected array $schedules = [];
protected BrokerPool $publisher;
+ protected ?BrokerPool $publisherRedis = null;
private ?Histogram $collectSchedulesTelemetryDuration = null;
private ?Gauge $collectSchedulesTelemetryCount = null;
@@ -72,6 +73,13 @@ abstract class ScheduleBase extends Action
Console::success(APP_NAME . ' ' . \ucfirst(static::getSupportedResource()) . ' scheduler v1 has started');
$this->publisher = new BrokerPool($pools->get('publisher'));
+
+ try {
+ $this->publisherRedis = new BrokerPool($pools->get('publisherRedis'));
+ } catch (\Throwable) {
+ $this->publisherRedis = null;
+ }
+
$this->scheduleTelemetryCount = $telemetry->createGauge('task.schedule.count');
$this->collectSchedulesTelemetryDuration = $telemetry->createHistogram('task.schedule.collect_schedules.duration', 's');
$this->collectSchedulesTelemetryCount = $telemetry->createGauge('task.schedule.collect_schedules.count');
diff --git a/src/Appwrite/Platform/Tasks/ScheduleExecutions.php b/src/Appwrite/Platform/Tasks/ScheduleExecutions.php
index 27a7c1dbf1..acb2dd3070 100644
--- a/src/Appwrite/Platform/Tasks/ScheduleExecutions.php
+++ b/src/Appwrite/Platform/Tasks/ScheduleExecutions.php
@@ -6,6 +6,7 @@ use Appwrite\Event\Func;
use Swoole\Coroutine as Co;
use Utopia\Database\Database;
use Utopia\Pools\Group;
+use Utopia\System\System;
class ScheduleExecutions extends ScheduleBase
{
@@ -29,9 +30,16 @@ class ScheduleExecutions extends ScheduleBase
protected function enqueueResources(Group $pools, Database $dbForPlatform, callable $getProjectDB): void
{
- $queueForFunctions = new Func($this->publisher);
$intervalEnd = (new \DateTime())->modify('+' . self::ENQUEUE_TIMER . ' seconds');
+ $isRedisFallback = \str_contains(System::getEnv('_APP_WORKER_REDIS_FALLBACK', ''), 'functions');
+
+ $queueForFunctions = new Func(
+ $isRedisFallback
+ ? $this->publisherRedis
+ : $this->publisher
+ );
+
foreach ($this->schedules as $schedule) {
if (!$schedule['active']) {
$dbForPlatform->deleteDocument(
diff --git a/src/Appwrite/Platform/Tasks/ScheduleFunctions.php b/src/Appwrite/Platform/Tasks/ScheduleFunctions.php
index 7812b27832..7a3363d74d 100644
--- a/src/Appwrite/Platform/Tasks/ScheduleFunctions.php
+++ b/src/Appwrite/Platform/Tasks/ScheduleFunctions.php
@@ -8,6 +8,7 @@ use Utopia\CLI\Console;
use Utopia\Database\Database;
use Utopia\Database\DateTime;
use Utopia\Pools\Group;
+use Utopia\System\System;
class ScheduleFunctions extends ScheduleBase
{
@@ -90,7 +91,13 @@ class ScheduleFunctions extends ScheduleBase
$this->updateProjectAccess($schedule['project'], $dbForPlatform);
- $queueForFunctions = new Func($this->publisher);
+ $isRedisFallback = \str_contains(System::getEnv('_APP_WORKER_REDIS_FALLBACK', ''), 'functions');
+
+ $queueForFunctions = new Func(
+ $isRedisFallback
+ ? $this->publisherRedis
+ : $this->publisher
+ );
$queueForFunctions
->setType('schedule')
diff --git a/src/Appwrite/Platform/Tasks/Screenshot.php b/src/Appwrite/Platform/Tasks/Screenshot.php
index 3a9c9a64f5..5a4d8a76b7 100644
--- a/src/Appwrite/Platform/Tasks/Screenshot.php
+++ b/src/Appwrite/Platform/Tasks/Screenshot.php
@@ -21,7 +21,7 @@ class Screenshot extends Action
$this
->desc('Create Site template screenshot')
->param('templateId', '', new Text(128), 'Template ID.')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $templateId): void
diff --git a/src/Appwrite/Platform/Tasks/StatsResources.php b/src/Appwrite/Platform/Tasks/StatsResources.php
index a0b5056b0f..b64dd61f86 100644
--- a/src/Appwrite/Platform/Tasks/StatsResources.php
+++ b/src/Appwrite/Platform/Tasks/StatsResources.php
@@ -45,7 +45,7 @@ class StatsResources extends Action
->inject('dbForPlatform')
->inject('logError')
->inject('queueForStatsResources')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(Database $dbForPlatform, callable $logError, EventStatsResources $queue): void
@@ -53,11 +53,14 @@ class StatsResources extends Action
$this->logError = $logError;
$this->dbForPlatform = $dbForPlatform;
+ $this->disableSubqueries();
+
Console::title("Stats resources V1");
Console::success('Stats resources: started');
$interval = (int) System::getEnv('_APP_STATS_RESOURCES_INTERVAL', '3600');
+
Console::loop(function () use ($queue) {
Authorization::disable();
Authorization::setDefaultStatus(false);
diff --git a/src/Appwrite/Platform/Tasks/Upgrade.php b/src/Appwrite/Platform/Tasks/Upgrade.php
index dfd10d347e..d6159d2718 100644
--- a/src/Appwrite/Platform/Tasks/Upgrade.php
+++ b/src/Appwrite/Platform/Tasks/Upgrade.php
@@ -23,7 +23,7 @@ class Upgrade extends Install
->param('image', 'appwrite', new Text(0), 'Main appwrite docker image', true)
->param('interactive', 'Y', new Text(1), 'Run an interactive session', true)
->param('no-start', false, new Boolean(true), 'Run an interactive session', true)
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(string $httpPort, string $httpsPort, string $organization, string $image, string $interactive, bool $noStart): void
diff --git a/src/Appwrite/Platform/Tasks/Vars.php b/src/Appwrite/Platform/Tasks/Vars.php
index 70ae550ef9..542b5bdc9f 100644
--- a/src/Appwrite/Platform/Tasks/Vars.php
+++ b/src/Appwrite/Platform/Tasks/Vars.php
@@ -18,7 +18,7 @@ class Vars extends Action
{
$this
->desc('List all the server environment variables')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(): void
diff --git a/src/Appwrite/Platform/Workers/Audits.php b/src/Appwrite/Platform/Workers/Audits.php
index 9d4bbbc408..04b562a219 100644
--- a/src/Appwrite/Platform/Workers/Audits.php
+++ b/src/Appwrite/Platform/Workers/Audits.php
@@ -45,7 +45,7 @@ class Audits extends Action
->inject('message')
->inject('getProjectDB')
->inject('project')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
$this->lastTriggeredTime = time();
}
diff --git a/src/Appwrite/Platform/Workers/Deletes.php b/src/Appwrite/Platform/Workers/Deletes.php
index 8ed96c76a2..2f41001b58 100644
--- a/src/Appwrite/Platform/Workers/Deletes.php
+++ b/src/Appwrite/Platform/Workers/Deletes.php
@@ -495,7 +495,7 @@ class Deletes extends Action
* @throws Authorization
* @throws DatabaseException
*/
- private function deleteProject(Database $dbForPlatform, callable $getProjectDB, Device $deviceForFiles, Device $deviceForSites, Device $deviceForFunctions, Device $deviceForBuilds, Device $deviceForCache, CertificatesAdapter $certificates, Document $document): void
+ protected function deleteProject(Database $dbForPlatform, callable $getProjectDB, Device $deviceForFiles, Device $deviceForSites, Device $deviceForFunctions, Device $deviceForBuilds, Device $deviceForCache, CertificatesAdapter $certificates, Document $document): void
{
$projectInternalId = $document->getSequence();
$projectId = $document->getId();
diff --git a/src/Appwrite/Platform/Workers/Functions.php b/src/Appwrite/Platform/Workers/Functions.php
index 8b3347775a..2c9ca16b0c 100644
--- a/src/Appwrite/Platform/Workers/Functions.php
+++ b/src/Appwrite/Platform/Workers/Functions.php
@@ -53,7 +53,7 @@ class Functions extends Action
->inject('log')
->inject('executor')
->inject('isResourceBlocked')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
public function action(
diff --git a/src/Appwrite/Platform/Workers/Mails.php b/src/Appwrite/Platform/Workers/Mails.php
index 3a15182e51..4e8b5e085c 100644
--- a/src/Appwrite/Platform/Workers/Mails.php
+++ b/src/Appwrite/Platform/Workers/Mails.php
@@ -29,7 +29,7 @@ class Mails extends Action
->inject('message')
->inject('register')
->inject('log')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
/**
diff --git a/src/Appwrite/Platform/Workers/Messaging.php b/src/Appwrite/Platform/Workers/Messaging.php
index 2ee107a319..668993fdae 100644
--- a/src/Appwrite/Platform/Workers/Messaging.php
+++ b/src/Appwrite/Platform/Workers/Messaging.php
@@ -72,7 +72,7 @@ class Messaging extends Action
->inject('dbForProject')
->inject('deviceForFiles')
->inject('queueForStatsUsage')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
/**
@@ -426,7 +426,7 @@ class Messaging extends Action
$credentials = $provider->getAttribute('credentials');
return match ($provider->getAttribute('provider')) {
- 'mock' => new Mock('username', 'password'),
+ 'mock' => (new Mock('username', 'password'))->setEndpoint('http://request-catcher-sms:5000/'),
'twilio' => new Twilio(
$credentials['accountSid'] ?? '',
$credentials['authToken'] ?? '',
diff --git a/src/Appwrite/Platform/Workers/Migrations.php b/src/Appwrite/Platform/Workers/Migrations.php
index b59308c288..39adb37374 100644
--- a/src/Appwrite/Platform/Workers/Migrations.php
+++ b/src/Appwrite/Platform/Workers/Migrations.php
@@ -69,7 +69,7 @@ class Migrations extends Action
->inject('logError')
->inject('queueForRealtime')
->inject('deviceForImports')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
/**
@@ -246,8 +246,11 @@ class Migrations extends Action
'functions.write',
'databases.read',
'collections.read',
+ 'tables.read',
'documents.read',
'documents.write',
+ 'rows.read',
+ 'rows.write',
'tokens.read',
'tokens.write',
]
@@ -314,6 +317,7 @@ class Migrations extends Action
$migration->getAttribute('resourceType')
);
}
+
$destination->shutDown();
$source->shutDown();
diff --git a/src/Appwrite/Platform/Workers/StatsResources.php b/src/Appwrite/Platform/Workers/StatsResources.php
index c68465f8df..98c9d01a87 100644
--- a/src/Appwrite/Platform/Workers/StatsResources.php
+++ b/src/Appwrite/Platform/Workers/StatsResources.php
@@ -49,7 +49,7 @@ class StatsResources extends Action
->inject('getLogsDB')
->inject('dbForPlatform')
->inject('logError')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
/**
diff --git a/src/Appwrite/Platform/Workers/StatsUsage.php b/src/Appwrite/Platform/Workers/StatsUsage.php
index 59b5a15ada..3610381d5a 100644
--- a/src/Appwrite/Platform/Workers/StatsUsage.php
+++ b/src/Appwrite/Platform/Workers/StatsUsage.php
@@ -119,7 +119,7 @@ class StatsUsage extends Action
->inject('getProjectDB')
->inject('getLogsDB')
->inject('register')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
$this->lastTriggeredTime = time();
}
diff --git a/src/Appwrite/Platform/Workers/Webhooks.php b/src/Appwrite/Platform/Workers/Webhooks.php
index 2ce39f8aaa..3ffc3f0aad 100644
--- a/src/Appwrite/Platform/Workers/Webhooks.php
+++ b/src/Appwrite/Platform/Workers/Webhooks.php
@@ -38,7 +38,7 @@ class Webhooks extends Action
->inject('queueForStatsUsage')
->inject('log')
->inject('plan')
- ->callback([$this, 'action']);
+ ->callback($this->action(...));
}
/**
diff --git a/src/Appwrite/SDK/Specification/Format/OpenAPI3.php b/src/Appwrite/SDK/Specification/Format/OpenAPI3.php
index b808a27f98..a9e24a2e44 100644
--- a/src/Appwrite/SDK/Specification/Format/OpenAPI3.php
+++ b/src/Appwrite/SDK/Specification/Format/OpenAPI3.php
@@ -383,8 +383,10 @@ class OpenAPI3 extends Format
'type' => $validator->getValidator()->getType(),
];
break;
+ case 'Appwrite\Utopia\Database\Validator\Queries\Columns':
case 'Appwrite\Utopia\Database\Validator\Queries\Attributes':
case 'Appwrite\Utopia\Database\Validator\Queries\Buckets':
+ case 'Appwrite\Utopia\Database\Validator\Queries\Tables':
case 'Appwrite\Utopia\Database\Validator\Queries\Collections':
case 'Appwrite\Utopia\Database\Validator\Queries\Databases':
case 'Appwrite\Utopia\Database\Validator\Queries\Deployments':
diff --git a/src/Appwrite/SDK/Specification/Format/Swagger2.php b/src/Appwrite/SDK/Specification/Format/Swagger2.php
index 4c4016e7e7..718144153f 100644
--- a/src/Appwrite/SDK/Specification/Format/Swagger2.php
+++ b/src/Appwrite/SDK/Specification/Format/Swagger2.php
@@ -141,6 +141,7 @@ class Swagger2 extends Format
$sdkPlatforms[] = APP_PLATFORM_CLIENT;
}
+ $sdkPlatforms = array_values(array_unique($sdkPlatforms));
$namespace = $sdk->getNamespace() ?? 'default';
$desc ??= '';
@@ -415,6 +416,8 @@ class Swagger2 extends Format
case 'Utopia\Database\Validator\Queries':
case 'Utopia\Database\Validator\Queries\Document':
case 'Utopia\Database\Validator\Queries\Documents':
+ case 'Appwrite\Utopia\Database\Validator\Queries\Columns':
+ case 'Appwrite\Utopia\Database\Validator\Queries\Tables':
$node['type'] = 'array';
$node['collectionFormat'] = 'multi';
$node['items'] = [
diff --git a/src/Appwrite/Utopia/Database/Validator/Queries/Attributes.php b/src/Appwrite/Utopia/Database/Validator/Queries/Attributes.php
index 4a35c82b73..953948c045 100644
--- a/src/Appwrite/Utopia/Database/Validator/Queries/Attributes.php
+++ b/src/Appwrite/Utopia/Database/Validator/Queries/Attributes.php
@@ -4,7 +4,7 @@ namespace Appwrite\Utopia\Database\Validator\Queries;
class Attributes extends Base
{
- public const ALLOWED_ATTRIBUTES = [
+ public const array ALLOWED_ATTRIBUTES = [
'key',
'type',
'size',
diff --git a/src/Appwrite/Utopia/Database/Validator/Queries/Collections.php b/src/Appwrite/Utopia/Database/Validator/Queries/Collections.php
index 6e8fcb8339..cdaaa104dc 100644
--- a/src/Appwrite/Utopia/Database/Validator/Queries/Collections.php
+++ b/src/Appwrite/Utopia/Database/Validator/Queries/Collections.php
@@ -4,7 +4,7 @@ namespace Appwrite\Utopia\Database\Validator\Queries;
class Collections extends Base
{
- public const ALLOWED_ATTRIBUTES = [
+ public const array ALLOWED_ATTRIBUTES = [
'name',
'enabled',
'documentSecurity'
diff --git a/src/Appwrite/Utopia/Database/Validator/Queries/Columns.php b/src/Appwrite/Utopia/Database/Validator/Queries/Columns.php
new file mode 100644
index 0000000000..c990dfc18a
--- /dev/null
+++ b/src/Appwrite/Utopia/Database/Validator/Queries/Columns.php
@@ -0,0 +1,25 @@
+setModel(new Error())
->setModel(new ErrorDev())
// Lists
+ ->setModel(new BaseList('Rows List', self::MODEL_ROW_LIST, 'rows', self::MODEL_ROW))
->setModel(new BaseList('Documents List', self::MODEL_DOCUMENT_LIST, 'documents', self::MODEL_DOCUMENT))
+ ->setModel(new BaseList('Tables List', self::MODEL_TABLE_LIST, 'tables', self::MODEL_TABLE))
->setModel(new BaseList('Collections List', self::MODEL_COLLECTION_LIST, 'collections', self::MODEL_COLLECTION))
->setModel(new BaseList('Databases List', self::MODEL_DATABASE_LIST, 'databases', self::MODEL_DATABASE))
->setModel(new BaseList('Indexes List', self::MODEL_INDEX_LIST, 'indexes', self::MODEL_INDEX))
+ ->setModel(new BaseList('Column Indexes List', self::MODEL_COLUMN_INDEX_LIST, 'indexes', self::MODEL_COLUMN_INDEX))
->setModel(new BaseList('Users List', self::MODEL_USER_LIST, 'users', self::MODEL_USER))
->setModel(new BaseList('Sessions List', self::MODEL_SESSION_LIST, 'sessions', self::MODEL_SESSION))
->setModel(new BaseList('Identities List', self::MODEL_IDENTITY_LIST, 'identities', self::MODEL_IDENTITY))
@@ -428,6 +468,7 @@ class Response extends SwooleResponse
->setModel(new BaseList('VCS Content List', self::MODEL_VCS_CONTENT_LIST, 'contents', self::MODEL_VCS_CONTENT))
// Entities
->setModel(new Database())
+ // Collection API Models
->setModel(new Collection())
->setModel(new Attribute())
->setModel(new AttributeList())
@@ -441,7 +482,23 @@ class Response extends SwooleResponse
->setModel(new AttributeURL())
->setModel(new AttributeDatetime())
->setModel(new AttributeRelationship())
+ // Table API Models
+ ->setModel(new Table())
+ ->setModel(new Column())
+ ->setModel(new ColumnList())
+ ->setModel(new ColumnString())
+ ->setModel(new ColumnInteger())
+ ->setModel(new ColumnFloat())
+ ->setModel(new ColumnBoolean())
+ ->setModel(new ColumnEmail())
+ ->setModel(new ColumnEnum())
+ ->setModel(new ColumnIP())
+ ->setModel(new ColumnURL())
+ ->setModel(new ColumnDatetime())
+ ->setModel(new ColumnRelationship())
->setModel(new Index())
+ ->setModel(new ColumnIndex())
+ ->setModel(new Row())
->setModel(new ModelDocument())
->setModel(new Log())
->setModel(new User())
@@ -508,6 +565,7 @@ class Response extends SwooleResponse
->setModel(new MetricBreakdown())
->setModel(new UsageDatabases())
->setModel(new UsageDatabase())
+ ->setModel(new UsageTable())
->setModel(new UsageCollection())
->setModel(new UsageUsers())
->setModel(new UsageStorage())
@@ -558,7 +616,7 @@ class Response extends SwooleResponse
*
* @return self
*/
- public function setModel(Model $instance)
+ public function setModel(Model $instance): Response
{
$this->models[$instance->getType()] = $instance;
@@ -836,7 +894,7 @@ class Response extends SwooleResponse
/**
* Function to add a response filter, the order of filters are first in - first out.
*
- * @param $filter the response filter to set
+ * @param $filter - the response filter to set
*
* @return void
*/
diff --git a/src/Appwrite/Utopia/Response/Filters/V19.php b/src/Appwrite/Utopia/Response/Filters/V19.php
index 2025cb629d..88f8323da9 100644
--- a/src/Appwrite/Utopia/Response/Filters/V19.php
+++ b/src/Appwrite/Utopia/Response/Filters/V19.php
@@ -35,7 +35,7 @@ class V19 extends Filter
return $parsedResponse;
}
- protected function parseFunction(array $content)
+ protected function parseFunction(array $content): array
{
$content['deployment'] = $content['deploymentId'] ?? '';
unset($content['deploymentId']);
diff --git a/src/Appwrite/Utopia/Response/Model/BaseList.php b/src/Appwrite/Utopia/Response/Model/BaseList.php
index d4ba6b0ab7..dea5d476f2 100644
--- a/src/Appwrite/Utopia/Response/Model/BaseList.php
+++ b/src/Appwrite/Utopia/Response/Model/BaseList.php
@@ -32,15 +32,17 @@ class BaseList extends Model
if ($paging) {
$namesWithCap = [
- 'documents', 'collections', 'users', 'files', 'buckets', 'functions',
- 'deployments', 'executions', 'projects', 'webhooks', 'keys',
- 'platforms', 'rules', 'memberships', 'teams'
+ 'rows', 'tables', // new api
+ 'documents', 'collections', // legacy api
+ 'users', 'files', 'buckets', 'functions',
+ 'deployments', 'executions', 'projects',
+ 'webhooks', 'keys', 'platforms', 'rules', 'memberships', 'teams'
];
if (\in_array($name, $namesWithCap)) {
- $description = 'Total number of ' . $key . ' documents that matched your query used as reference for offset pagination. When the `total` number of ' . $key . ' documents available is greater than 5000, total returned will be capped at 5000, and cursor pagination should be used. Read more about [pagination](https://appwrite.io/docs/pagination).';
+ $description = 'Total number of ' . $key . ' rows that matched your query used as reference for offset pagination. When the `total` number of ' . $key . ' rows available is greater than 5000, total returned will be capped at 5000, and cursor pagination should be used. Read more about [pagination](https://appwrite.io/docs/pagination).';
} else {
- $description = 'Total number of ' . $key . ' documents that matched your query.';
+ $description = 'Total number of ' . $key . ' rows that matched your query.';
}
$this->addRule('total', [
diff --git a/src/Appwrite/Utopia/Response/Model/Column.php b/src/Appwrite/Utopia/Response/Model/Column.php
new file mode 100644
index 0000000000..5562de39f2
--- /dev/null
+++ b/src/Appwrite/Utopia/Response/Model/Column.php
@@ -0,0 +1,85 @@
+addRule('key', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Column Key.',
+ 'default' => '',
+ 'example' => 'fullName',
+ ])
+ ->addRule('type', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Column type.',
+ 'default' => '',
+ 'example' => 'string',
+ ])
+ ->addRule('status', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Column status. Possible values: `available`, `processing`, `deleting`, `stuck`, or `failed`',
+ 'default' => '',
+ 'example' => 'available',
+ ])
+ ->addRule('error', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Error message. Displays error generated on failure of creating or deleting an column.',
+ 'default' => '',
+ 'example' => 'string',
+ ])
+ ->addRule('required', [
+ 'type' => self::TYPE_BOOLEAN,
+ 'description' => 'Is column required?',
+ 'default' => false,
+ 'example' => true,
+ ])
+ ->addRule('array', [
+ 'type' => self::TYPE_BOOLEAN,
+ 'description' => 'Is column an array?',
+ 'default' => false,
+ 'required' => false,
+ 'example' => false,
+ ])
+ ->addRule('$createdAt', [
+ 'type' => self::TYPE_DATETIME,
+ 'description' => 'Column creation date in ISO 8601 format.',
+ 'default' => '',
+ 'example' => self::TYPE_DATETIME_EXAMPLE,
+ ])
+ ->addRule('$updatedAt', [
+ 'type' => self::TYPE_DATETIME,
+ 'description' => 'Column update date in ISO 8601 format.',
+ 'default' => '',
+ 'example' => self::TYPE_DATETIME_EXAMPLE,
+ ]);
+ }
+
+ public array $conditions = [];
+
+ /**
+ * Get Name
+ *
+ * @return string
+ */
+ public function getName(): string
+ {
+ return 'Column';
+ }
+
+ /**
+ * Get Collection
+ *
+ * @return string
+ */
+ public function getType(): string
+ {
+ return Response::MODEL_COLUMN;
+ }
+}
diff --git a/src/Appwrite/Utopia/Response/Model/ColumnBoolean.php b/src/Appwrite/Utopia/Response/Model/ColumnBoolean.php
new file mode 100644
index 0000000000..ffbfe0e793
--- /dev/null
+++ b/src/Appwrite/Utopia/Response/Model/ColumnBoolean.php
@@ -0,0 +1,59 @@
+addRule('key', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Column Key.',
+ 'default' => '',
+ 'example' => 'isEnabled',
+ ])
+ ->addRule('type', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Column type.',
+ 'default' => '',
+ 'example' => 'boolean',
+ ])
+ ->addRule('default', [
+ 'type' => self::TYPE_BOOLEAN,
+ 'description' => 'Default value for attribute when not provided. Cannot be set when attribute is required.',
+ 'default' => null,
+ 'required' => false,
+ 'example' => false
+ ])
+ ;
+ }
+
+ public array $conditions = [
+ 'type' => self::TYPE_BOOLEAN
+ ];
+
+ /**
+ * Get Name
+ *
+ * @return string
+ */
+ public function getName(): string
+ {
+ return 'ColumnBoolean';
+ }
+
+ /**
+ * Get Type
+ *
+ * @return string
+ */
+ public function getType(): string
+ {
+ return Response::MODEL_COLUMN_BOOLEAN;
+ }
+}
diff --git a/src/Appwrite/Utopia/Response/Model/ColumnDatetime.php b/src/Appwrite/Utopia/Response/Model/ColumnDatetime.php
new file mode 100644
index 0000000000..4c68102775
--- /dev/null
+++ b/src/Appwrite/Utopia/Response/Model/ColumnDatetime.php
@@ -0,0 +1,67 @@
+addRule('key', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Column Key.',
+ 'default' => '',
+ 'example' => 'birthDay',
+ ])
+ ->addRule('type', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Column type.',
+ 'default' => '',
+ 'example' => self::TYPE_DATETIME,
+ ])
+ ->addRule('format', [
+ 'type' => self::TYPE_DATETIME,
+ 'description' => 'ISO 8601 format.',
+ 'default' => APP_DATABASE_ATTRIBUTE_DATETIME,
+ 'example' => APP_DATABASE_ATTRIBUTE_DATETIME,
+ 'array' => false,
+ ])
+ ->addRule('default', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Default value for attribute when not provided. Only null is optional',
+ 'default' => null,
+ 'example' => self::TYPE_DATETIME_EXAMPLE,
+ 'array' => false,
+ 'required' => false,
+ ])
+ ;
+ }
+
+ public array $conditions = [
+ 'type' => self::TYPE_DATETIME
+ ];
+
+ /**
+ * Get Name
+ *
+ * @return string
+ */
+ public function getName(): string
+ {
+ return 'ColumnDatetime';
+ }
+
+ /**
+ * Get Type
+ *
+ * @return string
+ */
+ public function getType(): string
+ {
+ return Response::MODEL_COLUMN_DATETIME;
+ }
+}
diff --git a/src/Appwrite/Utopia/Response/Model/ColumnEmail.php b/src/Appwrite/Utopia/Response/Model/ColumnEmail.php
new file mode 100644
index 0000000000..446f993227
--- /dev/null
+++ b/src/Appwrite/Utopia/Response/Model/ColumnEmail.php
@@ -0,0 +1,66 @@
+addRule('key', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Column Key.',
+ 'default' => '',
+ 'example' => 'userEmail',
+ ])
+ ->addRule('type', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Column type.',
+ 'default' => '',
+ 'example' => 'string',
+ ])
+ ->addRule('format', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'String format.',
+ 'default' => APP_DATABASE_ATTRIBUTE_EMAIL,
+ 'example' => APP_DATABASE_ATTRIBUTE_EMAIL,
+ ])
+ ->addRule('default', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Default value for attribute when not provided. Cannot be set when attribute is required.',
+ 'default' => null,
+ 'required' => false,
+ 'example' => 'default@example.com',
+ ])
+ ;
+ }
+
+ public array $conditions = [
+ 'type' => self::TYPE_STRING,
+ 'format' => \APP_DATABASE_ATTRIBUTE_EMAIL
+ ];
+
+ /**
+ * Get Name
+ *
+ * @return string
+ */
+ public function getName(): string
+ {
+ return 'ColumnEmail';
+ }
+
+ /**
+ * Get Type
+ *
+ * @return string
+ */
+ public function getType(): string
+ {
+ return Response::MODEL_COLUMN_EMAIL;
+ }
+}
diff --git a/src/Appwrite/Utopia/Response/Model/ColumnEnum.php b/src/Appwrite/Utopia/Response/Model/ColumnEnum.php
new file mode 100644
index 0000000000..b0873a2f7b
--- /dev/null
+++ b/src/Appwrite/Utopia/Response/Model/ColumnEnum.php
@@ -0,0 +1,73 @@
+addRule('key', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Column Key.',
+ 'default' => '',
+ 'example' => 'status',
+ ])
+ ->addRule('type', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Column type.',
+ 'default' => '',
+ 'example' => 'string',
+ ])
+ ->addRule('elements', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Array of elements in enumerated type.',
+ 'default' => null,
+ 'example' => 'element',
+ 'array' => true,
+ ])
+ ->addRule('format', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'String format.',
+ 'default' => APP_DATABASE_ATTRIBUTE_ENUM,
+ 'example' => APP_DATABASE_ATTRIBUTE_ENUM,
+ ])
+ ->addRule('default', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Default value for attribute when not provided. Cannot be set when attribute is required.',
+ 'default' => null,
+ 'required' => false,
+ 'example' => 'element',
+ ])
+ ;
+ }
+
+ public array $conditions = [
+ 'type' => self::TYPE_STRING,
+ 'format' => \APP_DATABASE_ATTRIBUTE_ENUM
+ ];
+
+ /**
+ * Get Name
+ *
+ * @return string
+ */
+ public function getName(): string
+ {
+ return 'ColumnEnum';
+ }
+
+ /**
+ * Get Type
+ *
+ * @return string
+ */
+ public function getType(): string
+ {
+ return Response::MODEL_COLUMN_ENUM;
+ }
+}
diff --git a/src/Appwrite/Utopia/Response/Model/ColumnFloat.php b/src/Appwrite/Utopia/Response/Model/ColumnFloat.php
new file mode 100644
index 0000000000..5867ac8712
--- /dev/null
+++ b/src/Appwrite/Utopia/Response/Model/ColumnFloat.php
@@ -0,0 +1,73 @@
+addRule('key', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Column Key.',
+ 'default' => '',
+ 'example' => 'percentageCompleted',
+ ])
+ ->addRule('type', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Column type.',
+ 'default' => '',
+ 'example' => 'double',
+ ])
+ ->addRule('min', [
+ 'type' => self::TYPE_FLOAT,
+ 'description' => 'Minimum value to enforce for new documents.',
+ 'default' => null,
+ 'required' => false,
+ 'example' => 1.5,
+ ])
+ ->addRule('max', [
+ 'type' => self::TYPE_FLOAT,
+ 'description' => 'Maximum value to enforce for new documents.',
+ 'default' => null,
+ 'required' => false,
+ 'example' => 10.5,
+ ])
+ ->addRule('default', [
+ 'type' => self::TYPE_FLOAT,
+ 'description' => 'Default value for attribute when not provided. Cannot be set when attribute is required.',
+ 'default' => null,
+ 'required' => false,
+ 'example' => 2.5,
+ ])
+ ;
+ }
+
+ public array $conditions = [
+ 'type' => self::TYPE_FLOAT,
+ ];
+
+ /**
+ * Get Name
+ *
+ * @return string
+ */
+ public function getName(): string
+ {
+ return 'ColumnFloat';
+ }
+
+ /**
+ * Get Type
+ *
+ * @return string
+ */
+ public function getType(): string
+ {
+ return Response::MODEL_COLUMN_FLOAT;
+ }
+}
diff --git a/src/Appwrite/Utopia/Response/Model/ColumnIP.php b/src/Appwrite/Utopia/Response/Model/ColumnIP.php
new file mode 100644
index 0000000000..2ca7130720
--- /dev/null
+++ b/src/Appwrite/Utopia/Response/Model/ColumnIP.php
@@ -0,0 +1,66 @@
+addRule('key', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Column Key.',
+ 'default' => '',
+ 'example' => 'ipAddress',
+ ])
+ ->addRule('type', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Column type.',
+ 'default' => '',
+ 'example' => 'string',
+ ])
+ ->addRule('format', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'String format.',
+ 'default' => APP_DATABASE_ATTRIBUTE_IP,
+ 'example' => APP_DATABASE_ATTRIBUTE_IP,
+ ])
+ ->addRule('default', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Default value for attribute when not provided. Cannot be set when attribute is required.',
+ 'default' => null,
+ 'required' => false,
+ 'example' => '192.0.2.0',
+ ])
+ ;
+ }
+
+ public array $conditions = [
+ 'type' => self::TYPE_STRING,
+ 'format' => \APP_DATABASE_ATTRIBUTE_IP
+ ];
+
+ /**
+ * Get Name
+ *
+ * @return string
+ */
+ public function getName(): string
+ {
+ return 'ColumnIP';
+ }
+
+ /**
+ * Get Type
+ *
+ * @return string
+ */
+ public function getType(): string
+ {
+ return Response::MODEL_COLUMN_IP;
+ }
+}
diff --git a/src/Appwrite/Utopia/Response/Model/ColumnIndex.php b/src/Appwrite/Utopia/Response/Model/ColumnIndex.php
new file mode 100644
index 0000000000..bebc640fb2
--- /dev/null
+++ b/src/Appwrite/Utopia/Response/Model/ColumnIndex.php
@@ -0,0 +1,101 @@
+addRule('key', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Index Key.',
+ 'default' => '',
+ 'example' => 'index1',
+ ])
+ ->addRule('type', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Index type.',
+ 'default' => '',
+ 'example' => 'primary',
+ ])
+ ->addRule('status', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Index status. Possible values: `available`, `processing`, `deleting`, `stuck`, or `failed`',
+ 'default' => '',
+ 'example' => 'available',
+ ])
+ ->addRule('error', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Error message. Displays error generated on failure of creating or deleting an index.',
+ 'default' => '',
+ 'example' => 'string',
+ ])
+ ->addRule('columns', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Index columns.',
+ 'default' => [],
+ 'example' => [],
+ 'array' => true,
+ ])
+ ->addRule('lengths', [
+ 'type' => self::TYPE_INTEGER,
+ 'description' => 'Index columns length.',
+ 'default' => [],
+ 'example' => [],
+ 'array' => true,
+ ])
+ ->addRule('orders', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Index orders.',
+ 'default' => [],
+ 'example' => [],
+ 'array' => true,
+ 'required' => false,
+ ])
+ ->addRule('$createdAt', [
+ 'type' => self::TYPE_DATETIME,
+ 'description' => 'Index creation date in ISO 8601 format.',
+ 'default' => '',
+ 'example' => self::TYPE_DATETIME_EXAMPLE,
+ ])
+ ->addRule('$updatedAt', [
+ 'type' => self::TYPE_DATETIME,
+ 'description' => 'Index update date in ISO 8601 format.',
+ 'default' => '',
+ 'example' => self::TYPE_DATETIME_EXAMPLE,
+ ]);
+ }
+
+ /**
+ * Get Name
+ */
+ public function getName(): string
+ {
+ return 'Index';
+ }
+
+ /**
+ * Get Collection
+ */
+ public function getType(): string
+ {
+ return Response::MODEL_COLUMN_INDEX;
+ }
+
+ public function filter(Document $document): Document
+ {
+
+ $columns = $document->getAttribute('attributes', []);
+ $document
+ ->removeAttribute('attributes')
+ ->setAttribute('columns', $columns);
+
+ return $document;
+
+ }
+}
diff --git a/src/Appwrite/Utopia/Response/Model/ColumnInteger.php b/src/Appwrite/Utopia/Response/Model/ColumnInteger.php
new file mode 100644
index 0000000000..086f36a961
--- /dev/null
+++ b/src/Appwrite/Utopia/Response/Model/ColumnInteger.php
@@ -0,0 +1,72 @@
+addRule('key', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Column Key.',
+ 'default' => '',
+ 'example' => 'count',
+ ])
+ ->addRule('type', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Column type.',
+ 'default' => '',
+ 'example' => 'integer',
+ ])
+ ->addRule('min', [
+ 'type' => self::TYPE_INTEGER,
+ 'description' => 'Minimum value to enforce for new documents.',
+ 'default' => null,
+ 'required' => false,
+ 'example' => 1,
+ ])
+ ->addRule('max', [
+ 'type' => self::TYPE_INTEGER,
+ 'description' => 'Maximum value to enforce for new documents.',
+ 'default' => null,
+ 'required' => false,
+ 'example' => 10,
+ ])
+ ->addRule('default', [
+ 'type' => self::TYPE_INTEGER,
+ 'description' => 'Default value for attribute when not provided. Cannot be set when attribute is required.',
+ 'default' => null,
+ 'required' => false,
+ 'example' => 10,
+ ])
+ ;
+ }
+
+ public array $conditions = [
+ 'type' => self::TYPE_INTEGER,
+ ];
+
+ /**
+ * Get Name *
+ * @return string
+ */
+ public function getName(): string
+ {
+ return 'ColumnInteger';
+ }
+
+ /**
+ * Get Type
+ *
+ * @return string
+ */
+ public function getType(): string
+ {
+ return Response::MODEL_COLUMN_INTEGER;
+ }
+}
diff --git a/src/Appwrite/Utopia/Response/Model/ColumnList.php b/src/Appwrite/Utopia/Response/Model/ColumnList.php
new file mode 100644
index 0000000000..0c9f5a49b5
--- /dev/null
+++ b/src/Appwrite/Utopia/Response/Model/ColumnList.php
@@ -0,0 +1,58 @@
+addRule('total', [
+ 'type' => self::TYPE_INTEGER,
+ 'description' => 'Total number of columns in the given table.',
+ 'default' => 0,
+ 'example' => 5,
+ ])
+ ->addRule('columns', [
+ 'type' => [
+ Response::MODEL_COLUMN_BOOLEAN,
+ Response::MODEL_COLUMN_INTEGER,
+ Response::MODEL_COLUMN_FLOAT,
+ Response::MODEL_COLUMN_EMAIL,
+ Response::MODEL_COLUMN_ENUM,
+ Response::MODEL_COLUMN_URL,
+ Response::MODEL_COLUMN_IP,
+ Response::MODEL_COLUMN_DATETIME,
+ Response::MODEL_COLUMN_RELATIONSHIP,
+ Response::MODEL_COLUMN_STRING // needs to be last, since its condition would dominate any other string attribute
+ ],
+ 'description' => 'List of columns.',
+ 'default' => [],
+ 'array' => true
+ ])
+ ;
+ }
+
+ /**
+ * Get Name
+ *
+ * @return string
+ */
+ public function getName(): string
+ {
+ return 'Columns List';
+ }
+
+ /**
+ * Get Type
+ *
+ * @return string
+ */
+ public function getType(): string
+ {
+ return Response::MODEL_COLUMN_LIST;
+ }
+}
diff --git a/src/Appwrite/Utopia/Response/Model/ColumnRelationship.php b/src/Appwrite/Utopia/Response/Model/ColumnRelationship.php
new file mode 100644
index 0000000000..877982365b
--- /dev/null
+++ b/src/Appwrite/Utopia/Response/Model/ColumnRelationship.php
@@ -0,0 +1,96 @@
+addRule('relatedTable', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'The ID of the related table.',
+ 'default' => null,
+ 'example' => 'table',
+ ])
+ ->addRule('relationType', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'The type of the relationship.',
+ 'default' => '',
+ 'example' => 'oneToOne|oneToMany|manyToOne|manyToMany',
+ ])
+ ->addRule('twoWay', [
+ 'type' => self::TYPE_BOOLEAN,
+ 'description' => 'Is the relationship two-way?',
+ 'default' => false,
+ 'example' => false,
+ ])
+ ->addRule('twoWayKey', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'The key of the two-way relationship.',
+ 'default' => '',
+ 'example' => 'string',
+ ])
+ ->addRule('onDelete', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'How deleting the parent document will propagate to child documents.',
+ 'default' => 'restrict',
+ 'example' => 'restrict|cascade|setNull',
+ ])
+ ->addRule('side', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Whether this is the parent or child side of the relationship',
+ 'default' => '',
+ 'example' => 'parent|child',
+ ])
+ ;
+ }
+
+ public array $conditions = [
+ 'type' => self::TYPE_RELATIONSHIP,
+ ];
+
+ /**
+ * Get Name
+ *
+ * @return string
+ */
+ public function getName(): string
+ {
+ return 'ColumnRelationship';
+ }
+
+ /**
+ * Get Type
+ *
+ * @return string
+ */
+ public function getType(): string
+ {
+ return Response::MODEL_COLUMN_RELATIONSHIP;
+ }
+
+ /**
+ * Process Document before returning it to the client
+ *
+ * @return Document
+ */
+ public function filter(Document $document): Document
+ {
+ $options = $document->getAttribute('options');
+ if (!\is_null($options)) {
+ $document->setAttribute('relatedTable', $options['relatedCollection']);
+ $document->setAttribute('relationType', $options['relationType']);
+ $document->setAttribute('twoWay', $options['twoWay']);
+ $document->setAttribute('twoWayKey', $options['twoWayKey']);
+ $document->setAttribute('side', $options['side']);
+ $document->setAttribute('onDelete', $options['onDelete']);
+ }
+ return $document;
+ }
+}
diff --git a/src/Appwrite/Utopia/Response/Model/ColumnString.php b/src/Appwrite/Utopia/Response/Model/ColumnString.php
new file mode 100644
index 0000000000..f3a876b7a9
--- /dev/null
+++ b/src/Appwrite/Utopia/Response/Model/ColumnString.php
@@ -0,0 +1,60 @@
+addRule('size', [
+ 'type' => self::TYPE_INTEGER,
+ 'description' => 'Column size.',
+ 'default' => 0,
+ 'example' => 128,
+ ])
+ ->addRule('default', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Default value for column when not provided. Cannot be set when column is required.',
+ 'default' => null,
+ 'required' => false,
+ 'example' => 'default',
+ ])
+ ->addRule('encrypt', [
+ 'type' => self::TYPE_BOOLEAN,
+ 'description' => 'Defines whether this column is encrypted or not.',
+ 'default' => false,
+ 'required' => false,
+ 'example' => false,
+ ])
+ ;
+ }
+
+ public array $conditions = [
+ 'type' => self::TYPE_STRING,
+ ];
+
+ /**
+ * Get Name
+ *
+ * @return string
+ */
+ public function getName(): string
+ {
+ return 'ColumnString';
+ }
+
+ /**
+ * Get Type
+ *
+ * @return string
+ */
+ public function getType(): string
+ {
+ return Response::MODEL_COLUMN_STRING;
+ }
+}
diff --git a/src/Appwrite/Utopia/Response/Model/ColumnURL.php b/src/Appwrite/Utopia/Response/Model/ColumnURL.php
new file mode 100644
index 0000000000..12850b3907
--- /dev/null
+++ b/src/Appwrite/Utopia/Response/Model/ColumnURL.php
@@ -0,0 +1,66 @@
+addRule('key', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Column Key.',
+ 'default' => '',
+ 'example' => 'githubUrl',
+ ])
+ ->addRule('type', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Column type.',
+ 'default' => '',
+ 'example' => 'string',
+ ])
+ ->addRule('format', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'String format.',
+ 'default' => APP_DATABASE_ATTRIBUTE_URL,
+ 'example' => APP_DATABASE_ATTRIBUTE_URL,
+ ])
+ ->addRule('default', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Default value for column when not provided. Cannot be set when column is required.',
+ 'default' => null,
+ 'required' => false,
+ 'example' => 'https://example.com',
+ ])
+ ;
+ }
+
+ public array $conditions = [
+ 'type' => self::TYPE_STRING,
+ 'format' => \APP_DATABASE_ATTRIBUTE_URL
+ ];
+
+ /**
+ * Get Name
+ *
+ * @return string
+ */
+ public function getName(): string
+ {
+ return 'ColumnURL';
+ }
+
+ /**
+ * Get Type
+ *
+ * @return string
+ */
+ public function getType(): string
+ {
+ return Response::MODEL_COLUMN_URL;
+ }
+}
diff --git a/src/Appwrite/Utopia/Response/Model/Row.php b/src/Appwrite/Utopia/Response/Model/Row.php
new file mode 100644
index 0000000000..b7750feccd
--- /dev/null
+++ b/src/Appwrite/Utopia/Response/Model/Row.php
@@ -0,0 +1,104 @@
+addRule('$id', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Row ID.',
+ 'default' => '',
+ 'example' => '5e5ea5c16897e',
+ ])
+ ->addRule('$sequence', [
+ 'type' => self::TYPE_INTEGER,
+ 'description' => 'Row automatically incrementing ID.',
+ 'default' => 0,
+ 'example' => 1,
+ ])
+ ->addRule('$tableId', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Table ID.',
+ 'default' => '',
+ 'example' => '5e5ea5c15117e',
+ ])
+ ->addRule('$databaseId', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Database ID.',
+ 'default' => '',
+ 'example' => '5e5ea5c15117e',
+ ])
+ ->addRule('$createdAt', [
+ 'type' => self::TYPE_DATETIME,
+ 'description' => 'Row creation date in ISO 8601 format.',
+ 'default' => '',
+ 'example' => self::TYPE_DATETIME_EXAMPLE,
+ ])
+ ->addRule('$updatedAt', [
+ 'type' => self::TYPE_DATETIME,
+ 'description' => 'Row update date in ISO 8601 format.',
+ 'default' => '',
+ 'example' => self::TYPE_DATETIME_EXAMPLE,
+ ])
+ ->addRule('$permissions', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Row permissions. [Learn more about permissions](https://appwrite.io/docs/permissions).',
+ 'default' => '',
+ 'example' => ['read("any")'],
+ 'array' => true,
+ ]);
+ }
+
+ public function filter(DatabaseDocument $document): DatabaseDocument
+ {
+ $document->removeAttribute('$collection');
+ $document->removeAttribute('$tenant');
+
+ $collectionId = $document->getAttribute('$collectionId', '');
+ if (!empty($collectionId)) {
+ $document
+ ->removeAttribute('$collectionId')
+ ->setAttribute('$tableId', $collectionId);
+ }
+
+ foreach ($document->getAttributes() as $column) {
+ if (\is_array($column)) {
+ foreach ($column as $subAttribute) {
+ if ($subAttribute instanceof DatabaseDocument) {
+ $this->filter($subAttribute);
+ }
+ }
+ } elseif ($column instanceof DatabaseDocument) {
+ $this->filter($column);
+ }
+ }
+
+ return $document;
+ }
+}
diff --git a/src/Appwrite/Utopia/Response/Model/Table.php b/src/Appwrite/Utopia/Response/Model/Table.php
new file mode 100644
index 0000000000..722edcd4cf
--- /dev/null
+++ b/src/Appwrite/Utopia/Response/Model/Table.php
@@ -0,0 +1,152 @@
+addRule('$id', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Table ID.',
+ 'default' => '',
+ 'example' => '5e5ea5c16897e',
+ ])
+ ->addRule('$createdAt', [
+ 'type' => self::TYPE_DATETIME,
+ 'description' => 'Table creation date in ISO 8601 format.',
+ 'default' => '',
+ 'example' => self::TYPE_DATETIME_EXAMPLE,
+ ])
+ ->addRule('$updatedAt', [
+ 'type' => self::TYPE_DATETIME,
+ 'description' => 'Table update date in ISO 8601 format.',
+ 'default' => '',
+ 'example' => self::TYPE_DATETIME_EXAMPLE,
+ ])
+ ->addRule('$permissions', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Table permissions. [Learn more about permissions](https://appwrite.io/docs/permissions).',
+ 'default' => '',
+ 'example' => ['read("any")'],
+ 'array' => true
+ ])
+ ->addRule('databaseId', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Database ID.',
+ 'default' => '',
+ 'example' => '5e5ea5c16897e',
+ ])
+ ->addRule('name', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Table name.',
+ 'default' => '',
+ 'example' => 'My Table',
+ ])
+ ->addRule('enabled', [
+ 'type' => self::TYPE_BOOLEAN,
+ 'description' => 'Table enabled. Can be \'enabled\' or \'disabled\'. When disabled, the table is inaccessible to users, but remains accessible to Server SDKs using API keys.',
+ 'default' => true,
+ 'example' => false,
+ ])
+ ->addRule('rowSecurity', [
+ 'type' => self::TYPE_BOOLEAN,
+ 'description' => 'Whether row-level permissions are enabled. [Learn more about permissions](https://appwrite.io/docs/permissions).',
+ 'default' => '',
+ 'example' => true,
+ ])
+ ->addRule('columns', [
+ 'type' => [
+ Response::MODEL_COLUMN_BOOLEAN,
+ Response::MODEL_COLUMN_INTEGER,
+ Response::MODEL_COLUMN_FLOAT,
+ Response::MODEL_COLUMN_EMAIL,
+ Response::MODEL_COLUMN_ENUM,
+ Response::MODEL_COLUMN_URL,
+ Response::MODEL_COLUMN_IP,
+ Response::MODEL_COLUMN_DATETIME,
+ Response::MODEL_COLUMN_RELATIONSHIP,
+ Response::MODEL_COLUMN_STRING, // needs to be last, since its condition would dominate any other string attribute
+ ],
+ 'description' => 'Table columns.',
+ 'default' => [],
+ 'example' => new \stdClass(),
+ 'array' => true,
+ ])
+ ->addRule('indexes', [
+ 'type' => Response::MODEL_COLUMN_INDEX,
+ 'description' => 'Table indexes.',
+ 'default' => [],
+ 'example' => new \stdClass(),
+ 'array' => true
+ ])
+ ;
+ }
+
+ /**
+ * Get Name
+ *
+ * @return string
+ */
+ public function getName(): string
+ {
+ return 'Table';
+ }
+
+ /**
+ * Get Type
+ *
+ * @return string
+ */
+ public function getType(): string
+ {
+ return Response::MODEL_TABLE;
+ }
+
+ /**
+ * Process Document before returning it to the client for backwards compatibility!
+ */
+ public function filter(Document $document): Document
+ {
+ $columns = $document->getAttribute('attributes', []);
+ if (!empty($columns) && \is_array($columns)) {
+ $columns = $this->remapNestedRelatedCollections($columns);
+ }
+
+ $document->setAttribute('columns', $columns);
+
+ $related = $document->getAttribute('relatedCollection');
+ if ($related !== null) {
+ $document->setAttribute('relatedTable', $related);
+ }
+
+ $documentSecurity = $document->getAttribute('documentSecurity');
+ $document->setAttribute('rowSecurity', $documentSecurity);
+
+ // remove anyways as they are already copied above.
+ $document
+ ->removeAttribute('attributes')
+ ->removeAttribute('documentSecurity')
+ ->removeAttribute('relatedCollection');
+
+ return $document;
+ }
+
+ // 1.7 now sends back `relatedTable` instead of `relatedCollection`.
+ // This is necessary because the actual database underneath uses `relatedCollection`.
+ private function remapNestedRelatedCollections(array $columns): array
+ {
+ foreach ($columns as $i => $column) {
+ if (isset($column['relatedCollection'])) {
+ $columns[$i]['relatedTable'] = $column['relatedCollection'];
+ unset($columns[$i]['relatedCollection']);
+ }
+ }
+ return $columns;
+ }
+}
diff --git a/src/Appwrite/Utopia/Response/Model/UsageDatabase.php b/src/Appwrite/Utopia/Response/Model/UsageDatabase.php
index a0fe421f5f..990a2b3ee9 100644
--- a/src/Appwrite/Utopia/Response/Model/UsageDatabase.php
+++ b/src/Appwrite/Utopia/Response/Model/UsageDatabase.php
@@ -22,12 +22,24 @@ class UsageDatabase extends Model
'default' => 0,
'example' => 0,
])
+ ->addRule('tablesTotal', [
+ 'type' => self::TYPE_INTEGER,
+ 'description' => 'Total aggregated number of tables.',
+ 'default' => 0,
+ 'example' => 0,
+ ])
->addRule('documentsTotal', [
'type' => self::TYPE_INTEGER,
'description' => 'Total aggregated number of documents.',
'default' => 0,
'example' => 0,
])
+ ->addRule('rowsTotal', [
+ 'type' => self::TYPE_INTEGER,
+ 'description' => 'Total aggregated number of rows.',
+ 'default' => 0,
+ 'example' => 0,
+ ])
->addRule('storageTotal', [
'type' => self::TYPE_INTEGER,
'description' => 'Total aggregated number of total storage used in bytes.',
@@ -53,6 +65,13 @@ class UsageDatabase extends Model
'example' => [],
'array' => true
])
+ ->addRule('tables', [
+ 'type' => Response::MODEL_METRIC,
+ 'description' => 'Aggregated number of tables per period.',
+ 'default' => [],
+ 'example' => [],
+ 'array' => true
+ ])
->addRule('documents', [
'type' => Response::MODEL_METRIC,
'description' => 'Aggregated number of documents per period.',
@@ -60,6 +79,13 @@ class UsageDatabase extends Model
'example' => [],
'array' => true
])
+ ->addRule('rows', [
+ 'type' => Response::MODEL_METRIC,
+ 'description' => 'Aggregated number of rows per period.',
+ 'default' => [],
+ 'example' => [],
+ 'array' => true
+ ])
->addRule('storage', [
'type' => Response::MODEL_METRIC,
'description' => 'Aggregated storage used in bytes per period.',
diff --git a/src/Appwrite/Utopia/Response/Model/UsageDatabases.php b/src/Appwrite/Utopia/Response/Model/UsageDatabases.php
index 4e053e5223..67568c858c 100644
--- a/src/Appwrite/Utopia/Response/Model/UsageDatabases.php
+++ b/src/Appwrite/Utopia/Response/Model/UsageDatabases.php
@@ -28,12 +28,24 @@ class UsageDatabases extends Model
'default' => 0,
'example' => 0,
])
+ ->addRule('tablesTotal', [
+ 'type' => self::TYPE_INTEGER,
+ 'description' => 'Total aggregated number of tables.',
+ 'default' => 0,
+ 'example' => 0,
+ ])
->addRule('documentsTotal', [
'type' => self::TYPE_INTEGER,
'description' => 'Total aggregated number of documents.',
'default' => 0,
'example' => 0,
])
+ ->addRule('rowsTotal', [
+ 'type' => self::TYPE_INTEGER,
+ 'description' => 'Total aggregated number of rows.',
+ 'default' => 0,
+ 'example' => 0,
+ ])
->addRule('storageTotal', [
'type' => self::TYPE_INTEGER,
'description' => 'Total aggregated number of total databases storage in bytes.',
@@ -66,6 +78,13 @@ class UsageDatabases extends Model
'example' => [],
'array' => true
])
+ ->addRule('tables', [
+ 'type' => Response::MODEL_METRIC,
+ 'description' => 'Aggregated number of tables per period.',
+ 'default' => [],
+ 'example' => [],
+ 'array' => true
+ ])
->addRule('documents', [
'type' => Response::MODEL_METRIC,
'description' => 'Aggregated number of documents per period.',
@@ -73,6 +92,13 @@ class UsageDatabases extends Model
'example' => [],
'array' => true
])
+ ->addRule('rows', [
+ 'type' => Response::MODEL_METRIC,
+ 'description' => 'Aggregated number of rows per period.',
+ 'default' => [],
+ 'example' => [],
+ 'array' => true
+ ])
->addRule('storage', [
'type' => Response::MODEL_METRIC,
'description' => 'An array of the aggregated number of databases storage in bytes per period.',
diff --git a/src/Appwrite/Utopia/Response/Model/UsageProject.php b/src/Appwrite/Utopia/Response/Model/UsageProject.php
index 395b19b7cd..ee644aa845 100644
--- a/src/Appwrite/Utopia/Response/Model/UsageProject.php
+++ b/src/Appwrite/Utopia/Response/Model/UsageProject.php
@@ -22,6 +22,12 @@ class UsageProject extends Model
'default' => 0,
'example' => 0,
])
+ ->addRule('rowsTotal', [
+ 'type' => self::TYPE_INTEGER,
+ 'description' => 'Total aggregated number of rows.',
+ 'default' => 0,
+ 'example' => 0,
+ ])
->addRule('databasesTotal', [
'type' => self::TYPE_INTEGER,
'description' => 'Total aggregated number of databases.',
diff --git a/src/Appwrite/Utopia/Response/Model/UsageTable.php b/src/Appwrite/Utopia/Response/Model/UsageTable.php
new file mode 100644
index 0000000000..553a4b5001
--- /dev/null
+++ b/src/Appwrite/Utopia/Response/Model/UsageTable.php
@@ -0,0 +1,54 @@
+addRule('range', [
+ 'type' => self::TYPE_STRING,
+ 'description' => 'Time range of the usage stats.',
+ 'default' => '',
+ 'example' => '30d',
+ ])
+ ->addRule('rowsTotal', [
+ 'type' => self::TYPE_INTEGER,
+ 'description' => 'Total aggregated number of of rows.',
+ 'default' => 0,
+ 'example' => 0,
+ ])
+ ->addRule('rows', [
+ 'type' => Response::MODEL_METRIC,
+ 'description' => 'Aggregated number of rows per period.',
+ 'default' => [],
+ 'example' => [],
+ 'array' => true
+ ])
+ ;
+ }
+
+ /**
+ * Get Name
+ *
+ * @return string
+ */
+ public function getName(): string
+ {
+ return 'UsageTable';
+ }
+
+ /**
+ * Get Type
+ *
+ * @return string
+ */
+ public function getType(): string
+ {
+ return Response::MODEL_USAGE_TABLE;
+ }
+}
diff --git a/src/Appwrite/Utopia/Response/Model/Webhook.php b/src/Appwrite/Utopia/Response/Model/Webhook.php
index 57abb4900d..af1e23447e 100644
--- a/src/Appwrite/Utopia/Response/Model/Webhook.php
+++ b/src/Appwrite/Utopia/Response/Model/Webhook.php
@@ -49,7 +49,10 @@ class Webhook extends Model
'type' => self::TYPE_STRING,
'description' => 'Webhook trigger events.',
'default' => [],
- 'example' => 'database.collections.update',
+ 'example' => [
+ 'databases.tables.update',
+ 'databases.collections.update'
+ ],
'array' => true,
])
->addRule('security', [
diff --git a/src/Appwrite/Vcs/Comment.php b/src/Appwrite/Vcs/Comment.php
index 5f528e660f..a66706a4a2 100644
--- a/src/Appwrite/Vcs/Comment.php
+++ b/src/Appwrite/Vcs/Comment.php
@@ -86,8 +86,8 @@ class Comment
$i = 0;
foreach ($projects as $projectId => $project) {
- $protocol = System::getEnv('_APP_OPTIONS_FORCE_HTTPS') == 'disabled' ? 'http' : 'https';
- $hostname = System::getEnv('_APP_CONSOLE_DOMAIN', System::getEnv('_APP_DOMAIN'));
+ $protocol = System::getEnv('_APP_OPTIONS_FORCE_HTTPS') === 'disabled' ? 'http' : 'https';
+ $hostname = System::getEnv('_APP_CONSOLE_DOMAIN', System::getEnv('_APP_DOMAIN', ''));
$text .= "## {$project['name']}\n\n";
$text .= "Project ID: `{$projectId}`\n\n";
@@ -200,8 +200,8 @@ class Comment
public function generatImage(string $pathLight, string $pathDark, string $alt, int $width): string
{
- $protocol = System::getEnv('_APP_OPTIONS_FORCE_HTTPS') == 'disabled' ? 'http' : 'https';
- $hostname = System::getEnv('_APP_CONSOLE_DOMAIN', System::getEnv('_APP_DOMAIN'));
+ $protocol = System::getEnv('_APP_OPTIONS_FORCE_HTTPS') === 'disabled' ? 'http' : 'https';
+ $hostname = System::getEnv('_APP_CONSOLE_DOMAIN', System::getEnv('_APP_DOMAIN', ''));
$imageLight = $protocol . '://' . $hostname . $pathLight;
$imageDark = $protocol . '://' . $hostname . $pathDark;
diff --git a/src/Executor/Executor.php b/src/Executor/Executor.php
index 15411f18ab..df4c5fd8f5 100644
--- a/src/Executor/Executor.php
+++ b/src/Executor/Executor.php
@@ -64,7 +64,8 @@ class Executor
string $destination = '',
array $variables = [],
string $command = null,
- string $outputDirectory = ''
+ string $outputDirectory = '',
+ string $runtimeEntrypoint = ''
) {
$runtimeId = "$projectId-$deploymentId-build";
$route = "/runtimes";
@@ -87,7 +88,8 @@ class Executor
'memory' => $memory,
'version' => $version,
'timeout' => $timeout,
- 'outputDirectory' => $outputDirectory
+ 'outputDirectory' => $outputDirectory,
+ 'runtimeEntrypoint' => $runtimeEntrypoint
];
@@ -186,9 +188,9 @@ class Executor
array $headers,
float $cpus,
int $memory,
- string $runtimeEntrypoint = null,
bool $logging,
- int $requestTimeout = null
+ string $runtimeEntrypoint = '',
+ ?int $requestTimeout = null
) {
if (empty($headers['host'])) {
$headers['host'] = System::getEnv('_APP_DOMAIN', '');
diff --git a/tests/e2e/General/AbuseTest.php b/tests/e2e/General/AbuseTest.php
index 898fbd4aff..cfd12b0e9f 100644
--- a/tests/e2e/General/AbuseTest.php
+++ b/tests/e2e/General/AbuseTest.php
@@ -26,9 +26,9 @@ class AbuseTest extends Scope
}
}
- public function testAbuseCreateDocument()
+ public function testAbuseCreateDocumentCollectionsAPI()
{
- $data = $this->createCollection();
+ $data = $this->createCollectionOrTable();
$databaseId = $data['databaseId'];
$collectionId = $data['collectionId'];
$max = 120;
@@ -52,9 +52,9 @@ class AbuseTest extends Scope
}
}
- public function testAbuseUpdateDocument()
+ public function testAbuseUpdateDocumentCollectionsAPI()
{
- $data = $this->createCollection();
+ $data = $this->createCollectionOrTable();
$databaseId = $data['databaseId'];
$collectionId = $data['collectionId'];
$max = 120;
@@ -90,9 +90,9 @@ class AbuseTest extends Scope
}
}
- public function testAbuseDeleteDocument()
+ public function testAbuseDeleteDocumentCollectionsAPI()
{
- $data = $this->createCollection();
+ $data = $this->createCollectionOrTable();
$databaseId = $data['databaseId'];
$collectionId = $data['collectionId'];
$max = 60;
@@ -124,6 +124,104 @@ class AbuseTest extends Scope
}
}
+ public function testAbuseCreateDocumentTablesAPI()
+ {
+ $data = $this->createCollectionOrTable(false);
+ $databaseId = $data['databaseId'];
+ $collectionId = $data['collectionId'];
+ $max = 120;
+
+ for ($i = 0; $i <= $max + 1; $i++) {
+ $response = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $collectionId . '/rows', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'The Hulk ' . $i,
+ ],
+ ]);
+
+ if ($i < $max) {
+ $this->assertEquals(201, $response['headers']['status-code']);
+ } else {
+ $this->assertEquals(429, $response['headers']['status-code']);
+ }
+ }
+ }
+
+ public function testAbuseUpdateDocumentTablesAPI()
+ {
+ $data = $this->createCollectionOrTable(false);
+ $databaseId = $data['databaseId'];
+ $collectionId = $data['collectionId'];
+ $max = 120;
+
+ $row = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $collectionId . '/rows', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ], [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'The Hulk',
+ ],
+ ]);
+
+ $rowId = $row['body']['$id'];
+
+ for ($i = 0; $i <= $max + 1; $i++) {
+ $response = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $collectionId . '/rows/' . $rowId, [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], [
+ 'data' => [
+ 'title' => 'The Hulk ' . $i,
+ ],
+ ]);
+
+ if ($i < $max) {
+ $this->assertEquals(200, $response['headers']['status-code']);
+ } else {
+ $this->assertEquals(429, $response['headers']['status-code']);
+ }
+ }
+ }
+
+ public function testAbuseDeleteDocumentTablesAPI()
+ {
+ $data = $this->createCollectionOrTable(false);
+ $databaseId = $data['databaseId'];
+ $collectionId = $data['collectionId'];
+ $max = 60;
+
+ for ($i = 0; $i <= $max + 1; $i++) {
+ $document = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $collectionId . '/rows', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ], [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'The Hulk',
+ ],
+ ]);
+
+ $documentId = $document['body']['$id'];
+
+ $response = $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $collectionId . '/rows/' . $documentId, [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ]);
+
+ if ($i < $max) {
+ $this->assertEquals(204, $response['headers']['status-code']);
+ } else {
+ $this->assertEquals(429, $response['headers']['status-code']);
+ }
+ }
+ }
+
public function testAbuseCreateFile()
{
$data = $this->createBucket();
@@ -211,7 +309,7 @@ class AbuseTest extends Scope
}
}
- private function createCollection(): array
+ private function createCollectionOrTable(bool $isCollection = true): array
{
$database = $this->client->call(Client::METHOD_POST, '/databases', array_merge([
'content-type' => 'application/json',
@@ -227,12 +325,16 @@ class AbuseTest extends Scope
$databaseId = $database['body']['$id'];
- $movies = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/collections', [
+ $endpoint = $isCollection ? 'collections' : 'tables';
+ $idParam = $isCollection ? 'collectionId' : 'tableId';
+ $attributePath = $isCollection ? 'attributes' : 'columns';
+
+ $movies = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . "/$endpoint", [
'content-type' => 'application/json',
'x-appwrite-project' => $this->getProject()['$id'],
'x-appwrite-key' => $this->getProject()['apiKey']
], [
- 'collectionId' => ID::unique(),
+ $idParam => ID::unique(),
'name' => 'Movies',
'permissions' => [
Permission::read(Role::any()),
@@ -244,7 +346,7 @@ class AbuseTest extends Scope
$collectionId = $movies['body']['$id'];
- $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/collections/' . $collectionId . '/attributes/string', [
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . "/$endpoint/" . $collectionId . "/$attributePath/string", [
'content-type' => 'application/json',
'x-appwrite-project' => $this->getProject()['$id'],
'x-appwrite-key' => $this->getProject()['apiKey']
diff --git a/tests/e2e/General/HTTPTest.php b/tests/e2e/General/HTTPTest.php
index 620409bb39..bce6e7206f 100644
--- a/tests/e2e/General/HTTPTest.php
+++ b/tests/e2e/General/HTTPTest.php
@@ -60,7 +60,7 @@ class HTTPTest extends Scope
'origin' => 'http://localhost',
]));
- $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertEquals(200, $response['headers']['status-code'], "Simple GET /robots.txt HTTP request failed: " . \json_encode($response));
$this->assertStringContainsString('# robotstxt.org/', $response['body']);
}
diff --git a/tests/e2e/General/UsageTest.php b/tests/e2e/General/UsageTest.php
index 6ff9dafada..f8f7ff4fc7 100644
--- a/tests/e2e/General/UsageTest.php
+++ b/tests/e2e/General/UsageTest.php
@@ -418,7 +418,7 @@ class UsageTest extends Scope
}
/** @depends testStorageStats */
- public function testPrepareDatabaseStats(array $data): array
+ public function testPrepareDatabaseStatsCollectionsAPI(array $data): array
{
$requestsTotal = $data['requestsTotal'];
@@ -583,9 +583,8 @@ class UsageTest extends Scope
]);
}
- /** @depends testPrepareDatabaseStats */
-
- public function testDatabaseStats(array $data): array
+ /** @depends testPrepareDatabaseStatsCollectionsAPI */
+ public function testDatabaseStatsCollectionsAPI(array $data): array
{
$databaseId = $data['databaseId'];
$collectionId = $data['collectionId'];
@@ -658,7 +657,258 @@ class UsageTest extends Scope
return $data;
}
- /** @depends testDatabaseStats */
+ /** @depends testDatabaseStatsCollectionsAPI */
+ public function testPrepareDatabaseStatsTablesAPI(array $data): array
+ {
+ $rowsTotal = 0;
+ $tablesTotal = 0;
+ $databasesTotal = $data['databasesTotal'];
+ $documentsTotal = $data['documentsTotal'];
+ $collectionsTotal = $data['collectionsTotal'];
+
+ $requestsTotal = $data['requestsTotal'];
+
+ for ($i = 0; $i < self::CREATE; $i++) {
+ $name = uniqid() . ' database';
+
+ $response = $this->client->call(
+ Client::METHOD_POST,
+ '/databases',
+ array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id']
+ ], $this->getHeaders()),
+ [
+ 'databaseId' => 'unique()',
+ 'name' => $name,
+ ]
+ );
+
+ $this->assertEquals($name, $response['body']['name']);
+ $this->assertNotEmpty($response['body']['$id']);
+
+ $requestsTotal += 1;
+ $databasesTotal += 1;
+
+ $databaseId = $response['body']['$id'];
+
+ if ($i < (self::CREATE / 2)) {
+ $response = $this->client->call(
+ Client::METHOD_DELETE,
+ '/databases/' . $databaseId,
+ array_merge([
+ 'x-appwrite-project' => $this->getProject()['$id']
+ ], $this->getHeaders()),
+ );
+
+ $this->assertEmpty($response['body']);
+
+ $databasesTotal -= 1;
+ $requestsTotal += 1;
+ }
+ }
+
+ for ($i = 0; $i < self::CREATE; $i++) {
+ $name = uniqid() . ' table';
+
+ $response = $this->client->call(
+ Client::METHOD_POST,
+ '/databases/' . $databaseId . '/tables',
+ array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id']
+ ], $this->getHeaders()),
+ [
+ 'tableId' => 'unique()',
+ 'name' => $name,
+ 'documentSecurity' => false,
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::create(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ ]
+ );
+
+ $this->assertEquals($name, $response['body']['name']);
+ $this->assertNotEmpty($response['body']['$id']);
+
+ $requestsTotal += 1;
+ $tablesTotal += 1;
+
+ $tableId = $response['body']['$id'];
+
+ if ($i < (self::CREATE / 2)) {
+ $response = $this->client->call(
+ Client::METHOD_DELETE,
+ '/databases/' . $databaseId . '/tables/' . $tableId,
+ array_merge([
+ 'x-appwrite-project' => $this->getProject()['$id']
+ ], $this->getHeaders()),
+ );
+
+ $this->assertEmpty($response['body']);
+
+ $tablesTotal -= 1;
+ $requestsTotal += 1;
+ }
+ }
+
+ $response = $this->client->call(
+ Client::METHOD_POST,
+ '/databases/' . $databaseId . '/tables/' . $tableId . '/columns' . '/string',
+ array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id']
+ ], $this->getHeaders()),
+ [
+ 'key' => 'name',
+ 'size' => 255,
+ 'required' => true,
+ ]
+ );
+
+ $this->assertEquals('name', $response['body']['key']);
+
+ sleep(self::WAIT);
+
+ $requestsTotal += 1;
+
+ for ($i = 0; $i < self::CREATE; $i++) {
+ $name = uniqid() . ' table';
+
+ $response = $this->client->call(
+ Client::METHOD_POST,
+ '/databases/' . $databaseId . '/tables/' . $tableId . '/rows',
+ array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id']
+ ], $this->getHeaders()),
+ [
+ 'rowId' => 'unique()',
+ 'data' => ['name' => $name]
+ ]
+ );
+
+ $this->assertEquals($name, $response['body']['name']);
+ $this->assertNotEmpty($response['body']['$id']);
+
+ $requestsTotal += 1;
+ $rowsTotal += 1;
+
+ $rowId = $response['body']['$id'];
+
+ if ($i < (self::CREATE / 2)) {
+ $response = $this->client->call(
+ Client::METHOD_DELETE,
+ '/databases/' . $databaseId . '/tables/' . $tableId . '/rows/' . $rowId,
+ array_merge([
+ 'x-appwrite-project' => $this->getProject()['$id']
+ ], $this->getHeaders()),
+ );
+
+ $this->assertEmpty($response['body']);
+
+ $rowsTotal -= 1;
+ $requestsTotal += 1;
+ }
+ }
+
+ return array_merge($data, [
+ 'databaseId' => $databaseId,
+ 'tableId' => $tableId,
+ 'requestsTotal' => $requestsTotal,
+ 'databasesTotal' => $databasesTotal,
+ 'tablesTotal' => $tablesTotal,
+ 'rowsTotal' => $rowsTotal,
+
+ // For clarity
+ 'absoluteRowsTotal' => $rowsTotal + $data['documentsTotal'],
+ 'absoluteTablesTotal' => $tablesTotal + $data['collectionsTotal'],
+ ]);
+ }
+
+ /** @depends testPrepareDatabaseStatsTablesAPI */
+ #[Retry(count: 1)]
+ public function testDatabaseStatsTablesAPI(array $data): array
+ {
+ $tableId = $data['tableId'];
+ $databaseId = $data['databaseId'];
+ $requestsTotal = $data['requestsTotal'];
+
+ $absoluteRowsTotal = $data['absoluteRowsTotal'];
+ $absoluteTablesTotal = $data['absoluteTablesTotal'];
+
+ $rowsTotal = $data['rowsTotal'];
+ $tablesTotal = $data['tablesTotal'];
+ $databasesTotal = $data['databasesTotal'];
+
+ sleep(self::WAIT);
+
+ $response = $this->client->call(
+ Client::METHOD_GET,
+ '/project/usage',
+ $this->getConsoleHeaders(),
+ [
+ 'period' => '1d',
+ 'startDate' => self::getToday(),
+ 'endDate' => self::getTomorrow(),
+ ]
+ );
+
+ $this->assertGreaterThanOrEqual(31, count($response['body']));
+ $this->assertCount(1, $response['body']['requests']);
+ $this->assertCount(1, $response['body']['network']);
+ $this->assertEquals($requestsTotal, $response['body']['requests'][array_key_last($response['body']['requests'])]['value']);
+ $this->validateDates($response['body']['requests']);
+ $this->assertEquals($databasesTotal, $response['body']['databasesTotal']);
+
+ // project level includes all i.e. documents + rows total.
+ $this->assertEquals($absoluteRowsTotal, $response['body']['rowsTotal']);
+
+ $response = $this->client->call(
+ Client::METHOD_GET,
+ '/databases/usage?range=30d',
+ $this->getConsoleHeaders()
+ );
+
+ $this->assertEquals($databasesTotal, $response['body']['databases'][array_key_last($response['body']['databases'])]['value']);
+ $this->validateDates($response['body']['databases']);
+
+ // database level includes all i.e. collections + tables total.
+ $this->assertEquals($absoluteTablesTotal, $response['body']['tables'][array_key_last($response['body']['tables'])]['value']); // database level
+ $this->validateDates($response['body']['tables']);
+
+ // database level includes all i.e. documents + rows total.
+ $this->assertEquals($absoluteRowsTotal, $response['body']['rows'][array_key_last($response['body']['rows'])]['value']);
+ $this->validateDates($response['body']['rows']);
+
+ $response = $this->client->call(
+ Client::METHOD_GET,
+ '/databases/' . $databaseId . '/usage?range=30d',
+ $this->getConsoleHeaders()
+ );
+
+ $this->assertEquals($tablesTotal, $response['body']['tables'][array_key_last($response['body']['tables'])]['value']);
+ $this->validateDates($response['body']['tables']);
+
+ $this->assertEquals($rowsTotal, $response['body']['rows'][array_key_last($response['body']['rows'])]['value']);
+ $this->validateDates($response['body']['rows']);
+
+ $response = $this->client->call(
+ Client::METHOD_GET,
+ '/databases/' . $databaseId . '/tables/' . $tableId . '/usage?range=30d',
+ $this->getConsoleHeaders()
+ );
+
+ $this->assertEquals($rowsTotal, $response['body']['rows'][array_key_last($response['body']['rows'])]['value']);
+ $this->validateDates($response['body']['rows']);
+
+ return $data;
+ }
+
+ /** @depends testDatabaseStatsTablesAPI */
public function testPrepareFunctionsStats(array $data): array
{
$executionTime = 0;
diff --git a/tests/e2e/Scopes/ProjectCustom.php b/tests/e2e/Scopes/ProjectCustom.php
index 51aebeaef7..c2b4896814 100644
--- a/tests/e2e/Scopes/ProjectCustom.php
+++ b/tests/e2e/Scopes/ProjectCustom.php
@@ -70,8 +70,12 @@ trait ProjectCustom
'databases.write',
'collections.read',
'collections.write',
+ 'tables.read',
+ 'tables.write',
'documents.read',
'documents.write',
+ 'rows.read',
+ 'rows.write',
'files.read',
'files.write',
'buckets.read',
@@ -140,7 +144,7 @@ trait ProjectCustom
'teams.*',
'users.*'
],
- 'url' => 'http://request-catcher:5000/webhook',
+ 'url' => 'http://request-catcher-webhook:5000/',
'security' => false,
]);
diff --git a/tests/e2e/Scopes/Scope.php b/tests/e2e/Scopes/Scope.php
index 2fa6416bf7..2ee0d0198e 100644
--- a/tests/e2e/Scopes/Scope.php
+++ b/tests/e2e/Scopes/Scope.php
@@ -13,6 +13,9 @@ abstract class Scope extends TestCase
use Retryable;
use Async;
+ public const REQUEST_TYPE_WEBHOOK = 'webhook';
+ public const REQUEST_TYPE_SMS = 'sms';
+
protected ?Client $client = null;
protected string $endpoint = 'http://localhost/v1';
@@ -37,18 +40,55 @@ abstract class Scope extends TestCase
if ($limit === 1) {
return end($emails);
} else {
- $lastEmails = array_slice($emails, -1 * $limit);
- return $lastEmails;
+ return array_slice($emails, -1 * $limit);
}
}
return [];
}
- protected function assertLastRequest(callable $probe, $timeoutMs = 20_000, $waitMs = 500): array
+ protected function extractQueryParamsFromEmailLink(string $html): array
{
- $this->assertEventually(function () use (&$request, $probe) {
- $request = json_decode(file_get_contents('http://request-catcher:5000/__last_request__'), true);
+ foreach (['/join-us?', '/verification?', '/recovery?'] as $prefix) {
+ $linkStart = strpos($html, $prefix);
+ if ($linkStart !== false) {
+ $hrefStart = strrpos(substr($html, 0, $linkStart), 'href="');
+ if ($hrefStart === false) {
+ continue;
+ }
+
+ $hrefStart += 6;
+ $hrefEnd = strpos($html, '"', $hrefStart);
+ if ($hrefEnd === false || $hrefStart >= $hrefEnd) {
+ continue;
+ }
+
+ $link = substr($html, $hrefStart, $hrefEnd - $hrefStart);
+ $link = strtok($link, '#'); // Remove `#title`
+ $queryStart = strpos($link, '?');
+ if ($queryStart === false) {
+ continue;
+ }
+
+ $queryString = substr($link, $queryStart + 1);
+ parse_str(html_entity_decode($queryString), $queryParams);
+ return $queryParams;
+ }
+ }
+
+ return [];
+ }
+
+ protected function assertLastRequest(callable $probe, string $type, $timeoutMs = 20_000, $waitMs = 500): array
+ {
+ $hostname = match ($type) {
+ 'webhook' => 'request-catcher-webhook',
+ 'sms' => 'request-catcher-sms',
+ default => throw new \Exception('Invalid request catcher type.'),
+ };
+
+ $this->assertEventually(function () use (&$request, $probe, $hostname) {
+ $request = json_decode(file_get_contents('http://' . $hostname . ':5000/__last_request__'), true);
$request['data'] = json_decode($request['data'], true);
call_user_func($probe, $request);
@@ -57,11 +97,16 @@ abstract class Scope extends TestCase
return $request;
}
+ /**
+ * @deprecated Use assertLastRequest instead. Used only historically in webhook tests
+ */
protected function getLastRequest(): array
{
+ $hostname = 'request-catcher-webhook';
+
sleep(2);
- $request = json_decode(file_get_contents('http://request-catcher:5000/__last_request__'), true);
+ $request = json_decode(file_get_contents('http://' . $hostname . ':5000/__last_request__'), true);
$request['data'] = json_decode($request['data'], true);
return $request;
diff --git a/tests/e2e/Services/Account/AccountCustomClientTest.php b/tests/e2e/Services/Account/AccountCustomClientTest.php
index b114a54c30..b63055072c 100644
--- a/tests/e2e/Services/Account/AccountCustomClientTest.php
+++ b/tests/e2e/Services/Account/AccountCustomClientTest.php
@@ -926,17 +926,18 @@ class AccountCustomClientTest extends Scope
$this->assertEquals($name, $lastEmail['to'][0]['name']);
$this->assertEquals('Account Verification', $lastEmail['subject']);
- $verification = substr($lastEmail['text'], strpos($lastEmail['text'], '&secret=', 0) + 8, 256);
- $expireTime = strpos($lastEmail['text'], 'expire=' . urlencode(DateTime::format(new \DateTime($response['body']['expire']))), 0);
- $this->assertNotFalse($expireTime);
+ $tokens = $this->extractQueryParamsFromEmailLink($lastEmail['html']);
+ $verification = $tokens['secret'];
+ $expectedExpire = DateTime::format(new \DateTime($response['body']['expire']));
+ $this->assertEquals($expectedExpire, $tokens['expire']);
- $secretTest = strpos($lastEmail['text'], 'secret=' . $response['body']['secret'], 0);
+ // Secret check
+ $this->assertArrayHasKey('secret', $tokens);
+ $this->assertNotEmpty($tokens['secret']);
- $this->assertNotFalse($secretTest);
-
- $userIDTest = strpos($lastEmail['text'], 'userId=' . $response['body']['userId'], 0);
-
- $this->assertNotFalse($userIDTest);
+ // User ID check
+ $this->assertArrayHasKey('userId', $tokens);
+ $this->assertNotEmpty($tokens['userId']);
/**
* Test for FAILURE
@@ -1228,19 +1229,25 @@ class AccountCustomClientTest extends Scope
$this->assertEquals($name, $lastEmail['to'][0]['name']);
$this->assertEquals('Password Reset', $lastEmail['subject']);
- $recovery = substr($lastEmail['text'], strpos($lastEmail['text'], '&secret=', 0) + 8, 256);
+ $tokens = $this->extractQueryParamsFromEmailLink($lastEmail['html']);
- $expireTime = strpos($lastEmail['text'], 'expire=' . urlencode(DateTime::format(new \DateTime($response['body']['expire']))), 0);
+ // Secret check
+ $this->assertArrayHasKey('secret', $tokens);
+ $this->assertNotEmpty($tokens['secret']);
+ $this->assertNotFalse($response['body']['secret']);
- $this->assertNotFalse($expireTime);
+ // User ID check
+ $this->assertArrayHasKey('userId', $tokens);
+ $this->assertNotEmpty($tokens['userId']);
+ $this->assertNotFalse($response['body']['userId']);
- $secretTest = strpos($lastEmail['text'], 'secret=' . $response['body']['secret'], 0);
-
- $this->assertNotFalse($secretTest);
-
- $userIDTest = strpos($lastEmail['text'], 'userId=' . $response['body']['userId'], 0);
-
- $this->assertNotFalse($userIDTest);
+ // Expire check
+ $this->assertArrayHasKey('expire', $tokens);
+ $this->assertNotEmpty($tokens['expire']);
+ $this->assertEquals(
+ DateTime::format(new \DateTime($response['body']['expire'])),
+ $tokens['expire']
+ );
/**
* Test for FAILURE
@@ -1278,7 +1285,7 @@ class AccountCustomClientTest extends Scope
$this->assertEquals(404, $response['headers']['status-code']);
- $data['recovery'] = $recovery;
+ $data['recovery'] = $tokens['secret'];
return $data;
}
@@ -1433,7 +1440,7 @@ class AccountCustomClientTest extends Scope
$this->assertEquals('otpuser2@appwrite.io', $lastEmail['to'][0]['address']);
$this->assertEquals('OTP for ' . $this->getProject()['name'] . ' Login', $lastEmail['subject']);
- // FInd 6 concurrent digits in email text - OTP
+ // Find 6 concurrent digits in email text - OTP
preg_match_all("/\b\d{6}\b/", $lastEmail['text'], $matches);
$code = ($matches[0] ?? [])[0] ?? '';
@@ -2204,14 +2211,13 @@ class AccountCustomClientTest extends Scope
$userId = $response['body']['userId'];
$smsRequest = $this->assertLastRequest(function (array $request) use ($number) {
- $this->assertEquals('http://request-catcher:5000/mock-sms', $request['url']);
$this->assertEquals('Appwrite Mock Message Sender', $request['headers']['User-Agent']);
$this->assertEquals('username', $request['headers']['X-Username']);
$this->assertEquals('password', $request['headers']['X-Key']);
$this->assertEquals('POST', $request['method']);
$this->assertEquals('+123456789', $request['data']['from']);
$this->assertEquals($number, $request['data']['to']);
- });
+ }, Scope::REQUEST_TYPE_SMS);
$data['token'] = $smsRequest['data']['message'];
$data['id'] = $userId;
@@ -2555,13 +2561,21 @@ class AccountCustomClientTest extends Scope
$this->assertEquals(201, $response['headers']['status-code']);
$this->assertNotEmpty($response['body']['$id']);
+ $this->assertNotEmpty($response['body']['$createdAt']);
$this->assertEmpty($response['body']['secret']);
$this->assertTrue((new DatetimeValidator())->isValid($response['body']['expire']));
- $smsRequest = $this->assertLastRequest(function ($request) {
+ $tokenCreatedAt = $response['body']['$createdAt'];
+
+ $smsRequest = $this->assertLastRequest(function ($request) use ($tokenCreatedAt) {
$this->assertArrayHasKey('data', $request);
- $this->assertArrayHasKey('message', $request['data']);
- });
+ $this->assertArrayHasKey('time', $request);
+ $this->assertArrayHasKey('message', $request['data'], "Last request missing message: " . \json_encode($request));
+
+ // Ensure we are not using token from last sms login
+ $tokenRecievedAt = $request['time'];
+ $this->assertGreaterThan($tokenCreatedAt, $tokenRecievedAt);
+ }, Scope::REQUEST_TYPE_SMS);
/**
* Test for FAILURE
diff --git a/tests/e2e/Services/Databases/DatabasesBase.php b/tests/e2e/Services/Databases/Legacy/DatabasesBase.php
similarity index 99%
rename from tests/e2e/Services/Databases/DatabasesBase.php
rename to tests/e2e/Services/Databases/Legacy/DatabasesBase.php
index 462d5010a5..3af7383c4d 100644
--- a/tests/e2e/Services/Databases/DatabasesBase.php
+++ b/tests/e2e/Services/Databases/Legacy/DatabasesBase.php
@@ -1,6 +1,6 @@
getSide() === 'server') {
// Server side can't get past the invalid key check anyway
@@ -1414,14 +1414,24 @@ trait DatabasesBase
$this->assertEquals($releaseYearIndex['body']['key'], $movies['body']['indexes'][1]['key']);
$this->assertEquals($releaseWithDate1['body']['key'], $movies['body']['indexes'][2]['key']);
$this->assertEquals($releaseWithDate2['body']['key'], $movies['body']['indexes'][3]['key']);
- foreach ($movies['body']['indexes'] as $index) {
- $this->assertEquals('available', $index['status']);
- }
+
+ $this->assertEventually(function () use ($databaseId, $data) {
+ $movies = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/collections/' . $data['moviesId'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ foreach ($movies['body']['indexes'] as $index) {
+ $this->assertEquals('available', $index['status']);
+ }
+
+ return true;
+ }, 60000, 500);
return $data;
}
-
/**
* @depends testCreateAttributes
*/
@@ -2079,7 +2089,6 @@ trait DatabasesBase
return ['documents' => $documents['body']['documents'], 'databaseId' => $databaseId];
}
-
/**
* @depends testListDocuments
*/
@@ -2830,7 +2839,7 @@ trait DatabasesBase
return $data;
}
- public function testInvalidDocumentStructure()
+ public function testInvalidDocumentStructure(): void
{
$database = $this->client->call(Client::METHOD_POST, '/databases', array_merge([
'content-type' => 'application/json',
@@ -3693,7 +3702,7 @@ trait DatabasesBase
$this->assertCount(1, $documentsUser2['body']['documents']);
}
- public function testEnforceCollectionPermissions()
+ public function testEnforceCollectionPermissions(): void
{
$database = $this->client->call(Client::METHOD_POST, '/databases', array_merge([
'content-type' => 'application/json',
@@ -3986,7 +3995,7 @@ trait DatabasesBase
/**
* @depends testUniqueIndexDuplicate
*/
- public function testPersistantCreatedAt(array $data): array
+ public function testPersistentCreatedAt(array $data): array
{
$headers = $this->getSide() === 'client' ? array_merge([
'content-type' => 'application/json',
@@ -5295,7 +5304,7 @@ trait DatabasesBase
], $this->getHeaders()), [
'documentId' => ID::unique(),
'data' => [
- 'longtext' => file_get_contents(__DIR__ . '/../../../resources/longtext.txt'),
+ 'longtext' => file_get_contents(__DIR__ . '../../../../../resources/longtext.txt'),
],
'permissions' => [
Permission::read(Role::user($this->getUser()['$id'])),
@@ -5523,13 +5532,11 @@ trait DatabasesBase
]), ['min' => 7]);
$this->assertEquals(400, $err['headers']['status-code']);
- // Test type error on non-numeric attribut
+ // Test type error on non-numeric attribute
$typeErr = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/collections/' . $collectionId . '/documents/' . $documentId . '/count/decrement', array_merge([
'content-type' => 'application/json',
'x-appwrite-project' => $this->getProject()['$id'],
]), ['value' => 'not-a-number']);
$this->assertEquals(400, $typeErr['headers']['status-code']);
}
-
-
}
diff --git a/tests/e2e/Services/Databases/DatabasesConsoleClientTest.php b/tests/e2e/Services/Databases/Legacy/DatabasesConsoleClientTest.php
similarity index 99%
rename from tests/e2e/Services/Databases/DatabasesConsoleClientTest.php
rename to tests/e2e/Services/Databases/Legacy/DatabasesConsoleClientTest.php
index 2266c91afe..e81730411b 100644
--- a/tests/e2e/Services/Databases/DatabasesConsoleClientTest.php
+++ b/tests/e2e/Services/Databases/Legacy/DatabasesConsoleClientTest.php
@@ -1,6 +1,6 @@
assertEquals(200, $response['headers']['status-code']);
- $this->assertEquals(11, count($response['body']));
+ $this->assertEquals(15, count($response['body']));
$this->assertEquals('24h', $response['body']['range']);
$this->assertIsNumeric($response['body']['documentsTotal']);
$this->assertIsNumeric($response['body']['collectionsTotal']);
diff --git a/tests/e2e/Services/Databases/DatabasesCustomClientTest.php b/tests/e2e/Services/Databases/Legacy/DatabasesCustomClientTest.php
similarity index 99%
rename from tests/e2e/Services/Databases/DatabasesCustomClientTest.php
rename to tests/e2e/Services/Databases/Legacy/DatabasesCustomClientTest.php
index 320508a114..699a2b8f25 100644
--- a/tests/e2e/Services/Databases/DatabasesCustomClientTest.php
+++ b/tests/e2e/Services/Databases/Legacy/DatabasesCustomClientTest.php
@@ -1,6 +1,6 @@
assertCount(64, $collection['body']['attributes']);
$this->assertCount(0, $collection['body']['indexes']);
- foreach ($collection['body']['attributes'] as $attribute) {
- $this->assertEquals('available', $attribute['status'], 'attribute: ' . $attribute['key']);
- }
+ $this->assertEventually(function () use ($databaseId, $collectionId) {
+ $collection = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/collections/' . $collectionId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ foreach ($collection['body']['attributes'] ?? [] as $attribute) {
+ $this->assertEquals(
+ 'available',
+ $attribute['status'],
+ 'attribute: ' . $attribute['key']
+ );
+ }
+
+ return true;
+ }, 60000, 500);
+
// Test indexLimit = 64
// MariaDB, MySQL, and MongoDB create 6 indexes per new collection
@@ -3650,7 +3665,7 @@ class DatabasesCustomServerTest extends Scope
$this->assertEquals(400, $doc3['headers']['status-code']);
}
- public function createRelationshipCollections()
+ public function createRelationshipCollections(): void
{
// Prepare the database with collections and relationships
$database = $this->client->call(Client::METHOD_POST, '/databases', [
@@ -3699,7 +3714,7 @@ class DatabasesCustomServerTest extends Scope
\sleep(2);
}
- public function cleanupRelationshipCollection()
+ public function cleanupRelationshipCollection(): void
{
$this->client->call(Client::METHOD_DELETE, '/databases/database1', [
'content-type' => 'application/json',
diff --git a/tests/e2e/Services/Databases/DatabasesPermissionsGuestTest.php b/tests/e2e/Services/Databases/Legacy/DatabasesPermissionsGuestTest.php
similarity index 99%
rename from tests/e2e/Services/Databases/DatabasesPermissionsGuestTest.php
rename to tests/e2e/Services/Databases/Legacy/DatabasesPermissionsGuestTest.php
index ca8753f374..abeef6c222 100644
--- a/tests/e2e/Services/Databases/DatabasesPermissionsGuestTest.php
+++ b/tests/e2e/Services/Databases/Legacy/DatabasesPermissionsGuestTest.php
@@ -1,6 +1,6 @@
client->call(Client::METHOD_POST, '/databases', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], [
+ 'databaseId' => ID::unique(),
+ 'name' => 'Test Database'
+ ]);
+
+ $this->assertNotEmpty($database['body']['$id']);
+ $this->assertEquals(201, $database['headers']['status-code']);
+ $this->assertEquals('Test Database', $database['body']['name']);
+
+ return ['databaseId' => $database['body']['$id']];
+ }
+
+ /**
+ * @depends testCreateDatabase
+ */
+ public function testCreateTable(array $data): array
+ {
+ $databaseId = $data['databaseId'];
+ /**
+ * Test for SUCCESS
+ */
+ $movies = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Movies',
+ 'rowSecurity' => true,
+ 'permissions' => [
+ Permission::create(Role::user($this->getUser()['$id'])),
+ ],
+ ]);
+
+ $this->assertEquals(201, $movies['headers']['status-code']);
+ $this->assertEquals($movies['body']['name'], 'Movies');
+
+ $actors = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Actors',
+ 'rowSecurity' => true,
+ 'permissions' => [
+ Permission::create(Role::user($this->getUser()['$id'])),
+ ],
+ ]);
+
+ $this->assertEquals(201, $actors['headers']['status-code']);
+ $this->assertEquals($actors['body']['name'], 'Actors');
+
+ return [
+ 'databaseId' => $databaseId,
+ 'moviesId' => $movies['body']['$id'],
+ 'actorsId' => $actors['body']['$id'],
+ ];
+ }
+
+ /**
+ * @depends testCreateTable
+ */
+ public function testConsoleProject(array $data): void
+ {
+ if ($this->getSide() === 'server') {
+ // Server side can't get past the invalid key check anyway
+ $this->expectNotToPerformAssertions();
+ return;
+ }
+
+ $response = $this->client->call(
+ Client::METHOD_GET,
+ '/databases/console/tables/' . $data['moviesId'] . '/rows',
+ array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => 'console',
+ ], $this->getHeaders())
+ );
+
+ $this->assertEquals(401, $response['headers']['status-code']);
+ $this->assertEquals('general_access_forbidden', $response['body']['type']);
+ $this->assertEquals('This endpoint is not available for the console project. The Appwrite Console is a reserved project ID and cannot be used with the Appwrite SDKs and APIs. Please check if your project ID is correct.', $response['body']['message']);
+
+ $response = $this->client->call(
+ Client::METHOD_GET,
+ '/databases/console/tables/' . $data['moviesId'] . '/rows',
+ array_merge([
+ 'content-type' => 'application/json',
+ // 'x-appwrite-project' => '', empty header
+ ], $this->getHeaders())
+ );
+ $this->assertEquals(401, $response['headers']['status-code']);
+ $this->assertEquals('No Appwrite project was specified. Please specify your project ID when initializing your Appwrite SDK.', $response['body']['message']);
+ }
+
+ /**
+ * @depends testCreateTable
+ */
+ public function testDisableTable(array $data): void
+ {
+ $databaseId = $data['databaseId'];
+ /**
+ * Test for SUCCESS
+ */
+ $response = $this->client->call(Client::METHOD_PUT, '/databases/' . $databaseId . '/tables/' . $data['moviesId'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'name' => 'Movies',
+ 'enabled' => false,
+ 'rowSecurity' => true,
+ ]);
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertFalse($response['body']['enabled']);
+
+ if ($this->getSide() === 'client') {
+ $responseCreateDocument = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Captain America',
+ ],
+ 'permissions' => [
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::delete(Role::user($this->getUser()['$id'])),
+ ],
+ ]);
+
+ $this->assertEquals(404, $responseCreateDocument['headers']['status-code']);
+
+ $responseListDocument = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(404, $responseListDocument['headers']['status-code']);
+
+ $responseGetDocument = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows/someID', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(404, $responseGetDocument['headers']['status-code']);
+ }
+
+ $response = $this->client->call(Client::METHOD_PUT, '/databases/' . $databaseId . '/tables/' . $data['moviesId'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'name' => 'Movies',
+ 'enabled' => true,
+ 'rowSecurity' => true,
+ ]);
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertTrue($response['body']['enabled']);
+ }
+
+ /**
+ * @depends testCreateTable
+ */
+ public function testCreateColumns(array $data): array
+ {
+ $databaseId = $data['databaseId'];
+
+ $title = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'title',
+ 'size' => 256,
+ 'required' => true,
+ ]);
+
+ $description = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'description',
+ 'size' => 512,
+ 'required' => false,
+ 'default' => '',
+ ]);
+
+ $tagline = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'tagline',
+ 'size' => 512,
+ 'required' => false,
+ 'default' => '',
+ ]);
+
+ $releaseYear = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/columns/integer', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'releaseYear',
+ 'required' => true,
+ 'min' => 1900,
+ 'max' => 2200,
+ ]);
+
+ $duration = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/columns/integer', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'duration',
+ 'required' => false,
+ 'min' => 60,
+ ]);
+
+ $actors = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'actors',
+ 'size' => 256,
+ 'required' => false,
+ 'array' => true,
+ ]);
+
+ $datetime = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/columns/datetime', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'birthDay',
+ 'required' => false,
+ ]);
+
+ $relationship = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'relatedTableId' => $data['actorsId'],
+ 'type' => 'oneToMany',
+ 'twoWay' => true,
+ 'key' => 'starringActors',
+ 'twoWayKey' => 'movie'
+ ]);
+
+ $integers = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/columns/integer', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'integers',
+ 'required' => false,
+ 'array' => true,
+ 'min' => 10,
+ 'max' => 99,
+ ]);
+
+ $this->assertEquals(202, $title['headers']['status-code']);
+ $this->assertEquals($title['body']['key'], 'title');
+ $this->assertEquals($title['body']['type'], 'string');
+ $this->assertEquals($title['body']['size'], 256);
+ $this->assertEquals($title['body']['required'], true);
+
+ $this->assertEquals(202, $description['headers']['status-code']);
+ $this->assertEquals($description['body']['key'], 'description');
+ $this->assertEquals($description['body']['type'], 'string');
+ $this->assertEquals($description['body']['size'], 512);
+ $this->assertEquals($description['body']['required'], false);
+ $this->assertEquals($description['body']['default'], '');
+
+ $this->assertEquals(202, $tagline['headers']['status-code']);
+ $this->assertEquals($tagline['body']['key'], 'tagline');
+ $this->assertEquals($tagline['body']['type'], 'string');
+ $this->assertEquals($tagline['body']['size'], 512);
+ $this->assertEquals($tagline['body']['required'], false);
+ $this->assertEquals($tagline['body']['default'], '');
+
+ $this->assertEquals(202, $releaseYear['headers']['status-code']);
+ $this->assertEquals($releaseYear['body']['key'], 'releaseYear');
+ $this->assertEquals($releaseYear['body']['type'], 'integer');
+ $this->assertEquals($releaseYear['body']['required'], true);
+
+ $this->assertEquals(202, $duration['headers']['status-code']);
+ $this->assertEquals($duration['body']['key'], 'duration');
+ $this->assertEquals($duration['body']['type'], 'integer');
+ $this->assertEquals($duration['body']['required'], false);
+
+ $this->assertEquals(202, $actors['headers']['status-code']);
+ $this->assertEquals($actors['body']['key'], 'actors');
+ $this->assertEquals($actors['body']['type'], 'string');
+ $this->assertEquals($actors['body']['size'], 256);
+ $this->assertEquals($actors['body']['required'], false);
+ $this->assertEquals($actors['body']['array'], true);
+
+ $this->assertEquals($datetime['headers']['status-code'], 202);
+ $this->assertEquals($datetime['body']['key'], 'birthDay');
+ $this->assertEquals($datetime['body']['type'], 'datetime');
+ $this->assertEquals($datetime['body']['required'], false);
+
+ $this->assertEquals($relationship['headers']['status-code'], 202);
+ $this->assertEquals($relationship['body']['key'], 'starringActors');
+ $this->assertEquals($relationship['body']['type'], 'relationship');
+ $this->assertEquals($relationship['body']['relatedTable'], $data['actorsId']);
+ $this->assertEquals($relationship['body']['relationType'], 'oneToMany');
+ $this->assertEquals($relationship['body']['twoWay'], true);
+ $this->assertEquals($relationship['body']['twoWayKey'], 'movie');
+
+ $this->assertEquals(202, $integers['headers']['status-code']);
+ $this->assertEquals($integers['body']['key'], 'integers');
+ $this->assertEquals($integers['body']['type'], 'integer');
+ $this->assertArrayNotHasKey('size', $integers['body']);
+ $this->assertEquals($integers['body']['required'], false);
+ $this->assertEquals($integers['body']['array'], true);
+
+ // wait for database worker to create attributes
+ sleep(2);
+
+ $movies = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertIsArray($movies['body']['columns']);
+ $this->assertCount(9, $movies['body']['columns']);
+ $this->assertEquals($movies['body']['columns'][0]['key'], $title['body']['key']);
+ $this->assertEquals($movies['body']['columns'][1]['key'], $description['body']['key']);
+ $this->assertEquals($movies['body']['columns'][2]['key'], $tagline['body']['key']);
+ $this->assertEquals($movies['body']['columns'][3]['key'], $releaseYear['body']['key']);
+ $this->assertEquals($movies['body']['columns'][4]['key'], $duration['body']['key']);
+ $this->assertEquals($movies['body']['columns'][5]['key'], $actors['body']['key']);
+ $this->assertEquals($movies['body']['columns'][6]['key'], $datetime['body']['key']);
+ $this->assertEquals($movies['body']['columns'][7]['key'], $relationship['body']['key']);
+ $this->assertEquals($movies['body']['columns'][8]['key'], $integers['body']['key']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateColumns
+ */
+ public function testListColumns(array $data): void
+ {
+ $databaseId = $data['databaseId'];
+ $response = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/columns', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ]), [
+ 'queries' => [
+ Query::equal('type', ['string'])->toString(),
+ Query::limit(2)->toString(),
+ Query::cursorAfter(new Document(['$id' => 'title']))->toString()
+ ],
+ ]);
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertEquals(2, \count($response['body']['columns']));
+ $response = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/columns', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ]), [
+ 'queries' => [Query::select(['key'])->toString()],
+ ]);
+ $this->assertEquals(Exception::GENERAL_ARGUMENT_INVALID, $response['body']['type']);
+ $this->assertEquals(400, $response['headers']['status-code']);
+ }
+
+ /**
+ * @depends testCreateDatabase
+ */
+ public function testPatchColumn(array $data): void
+ {
+ $databaseId = $data['databaseId'];
+
+ $table = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'patch',
+ 'rowSecurity' => true,
+ 'permissions' => [
+ Permission::create(Role::user($this->getUser()['$id'])),
+ ],
+ ]);
+
+ $this->assertEquals(201, $table['headers']['status-code']);
+ $this->assertEquals($table['body']['name'], 'patch');
+
+ $attribute = $this->client->call(Client::METHOD_POST, '/databases/'.$databaseId.'/tables/'.$table['body']['$id'].'/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'title',
+ 'required' => true,
+ 'size' => 100,
+ ]);
+ $this->assertEquals(202, $attribute['headers']['status-code']);
+ $this->assertEquals($attribute['body']['size'], 100);
+
+ sleep(1);
+
+ $index = $this->client->call(Client::METHOD_POST, '/databases/'.$databaseId.'/tables/'.$table['body']['$id'].'/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'titleIndex',
+ 'type' => 'key',
+ 'columns' => ['title'],
+ ]);
+ $this->assertEquals(202, $index['headers']['status-code']);
+
+ sleep(1);
+
+ /**
+ * Update attribute size to exceed Index maximum length
+ */
+ $attribute = $this->client->call(Client::METHOD_PATCH, '/databases/'.$databaseId.'/tables/'.$table['body']['$id'].'/columns/string/'.$attribute['body']['key'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ]), [
+ 'size' => 1000,
+ 'required' => true,
+ 'default' => null,
+ ]);
+
+ $this->assertEquals(400, $attribute['headers']['status-code']);
+ $this->assertStringContainsString('Index length is longer than the maximum: 76', $attribute['body']['message']);
+ }
+
+ public function testUpdateColumnEnum(): void
+ {
+ $database = $this->client->call(Client::METHOD_POST, '/databases', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], [
+ 'databaseId' => ID::unique(),
+ 'name' => 'Test Database 2'
+ ]);
+
+ $players = $this->client->call(Client::METHOD_POST, '/databases/' . $database['body']['$id'] . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Players',
+ 'rowSecurity' => true,
+ 'permissions' => [
+ Permission::create(Role::user($this->getUser()['$id'])),
+ ],
+ ]);
+
+ // Create enum attribute
+ $attribute = $this->client->call(Client::METHOD_POST, '/databases/' . $database['body']['$id'] . '/tables/' . $players['body']['$id'] . '/columns/enum', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ]), [
+ 'key' => 'position',
+ 'elements' => ['goalkeeper', 'defender', 'midfielder', 'forward'],
+ 'required' => true,
+ 'array' => false,
+ ]);
+
+ $this->assertEquals(202, $attribute['headers']['status-code']);
+ $this->assertEquals($attribute['body']['key'], 'position');
+ $this->assertEquals($attribute['body']['elements'], ['goalkeeper', 'defender', 'midfielder', 'forward']);
+
+ \sleep(2);
+
+ // Update enum attribute
+ $attribute = $this->client->call(Client::METHOD_PATCH, '/databases/' . $database['body']['$id'] . '/tables/' . $players['body']['$id'] . '/columns/enum/' . $attribute['body']['key'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ]), [
+ 'elements' => ['goalkeeper', 'defender', 'midfielder', 'forward', 'coach'],
+ 'required' => true,
+ 'default' => null
+ ]);
+
+ $this->assertEquals(200, $attribute['headers']['status-code']);
+ $this->assertEquals($attribute['body']['elements'], ['goalkeeper', 'defender', 'midfielder', 'forward', 'coach']);
+ }
+
+ /**
+ * @depends testCreateColumns
+ */
+ public function testColumnResponseModels(array $data): array
+ {
+ $databaseId = $data['databaseId'];
+ $table = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Response Models',
+ // 'permissions' missing on purpose to make sure it's optional
+ 'rowSecurity' => true,
+ ]);
+
+ $this->assertEquals(201, $table['headers']['status-code']);
+ $this->assertEquals($table['body']['name'], 'Response Models');
+
+ $tableId = $table['body']['$id'];
+
+ $columnsPath = "/databases/" . $databaseId . "/tables/{$tableId}/columns";
+
+ $string = $this->client->call(Client::METHOD_POST, $columnsPath . '/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'string',
+ 'size' => 16,
+ 'required' => false,
+ 'default' => 'default',
+ ]);
+
+ $email = $this->client->call(Client::METHOD_POST, $columnsPath . '/email', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'email',
+ 'required' => false,
+ 'default' => 'default@example.com',
+ ]);
+
+ $enum = $this->client->call(Client::METHOD_POST, $columnsPath . '/enum', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'enum',
+ 'elements' => ['yes', 'no', 'maybe'],
+ 'required' => false,
+ 'default' => 'maybe',
+ ]);
+
+ $ip = $this->client->call(Client::METHOD_POST, $columnsPath . '/ip', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'ip',
+ 'required' => false,
+ 'default' => '192.0.2.0',
+ ]);
+
+ $url = $this->client->call(Client::METHOD_POST, $columnsPath . '/url', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'url',
+ 'required' => false,
+ 'default' => 'http://example.com',
+ ]);
+
+ $integer = $this->client->call(Client::METHOD_POST, $columnsPath . '/integer', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'integer',
+ 'required' => false,
+ 'min' => 1,
+ 'max' => 5,
+ 'default' => 3
+ ]);
+
+ $float = $this->client->call(Client::METHOD_POST, $columnsPath . '/float', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'float',
+ 'required' => false,
+ 'min' => 1.5,
+ 'max' => 5.5,
+ 'default' => 3.5
+ ]);
+
+ $boolean = $this->client->call(Client::METHOD_POST, $columnsPath . '/boolean', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'boolean',
+ 'required' => false,
+ 'default' => true,
+ ]);
+
+ $datetime = $this->client->call(Client::METHOD_POST, $columnsPath . '/datetime', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'datetime',
+ 'required' => false,
+ 'default' => null,
+ ]);
+
+ $relationship = $this->client->call(Client::METHOD_POST, $columnsPath . '/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'relatedTableId' => $data['actorsId'],
+ 'type' => 'oneToMany',
+ 'twoWay' => true,
+ 'key' => 'relationship',
+ 'twoWayKey' => 'twoWayKey'
+ ]);
+
+ $strings = $this->client->call(Client::METHOD_POST, $columnsPath . '/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'names',
+ 'size' => 512,
+ 'required' => false,
+ 'array' => true,
+ ]);
+
+ $integers = $this->client->call(Client::METHOD_POST, $columnsPath . '/integer', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'numbers',
+ 'required' => false,
+ 'array' => true,
+ 'min' => 1,
+ 'max' => 999,
+ ]);
+
+ $this->assertEquals(202, $string['headers']['status-code']);
+ $this->assertEquals('string', $string['body']['key']);
+ $this->assertEquals('string', $string['body']['type']);
+ $this->assertEquals(false, $string['body']['required']);
+ $this->assertEquals(false, $string['body']['array']);
+ $this->assertEquals(16, $string['body']['size']);
+ $this->assertEquals('default', $string['body']['default']);
+
+ $this->assertEquals(202, $email['headers']['status-code']);
+ $this->assertEquals('email', $email['body']['key']);
+ $this->assertEquals('string', $email['body']['type']);
+ $this->assertEquals(false, $email['body']['required']);
+ $this->assertEquals(false, $email['body']['array']);
+ $this->assertEquals('email', $email['body']['format']);
+ $this->assertEquals('default@example.com', $email['body']['default']);
+
+ $this->assertEquals(202, $enum['headers']['status-code']);
+ $this->assertEquals('enum', $enum['body']['key']);
+ $this->assertEquals('string', $enum['body']['type']);
+ $this->assertEquals(false, $enum['body']['required']);
+ $this->assertEquals(false, $enum['body']['array']);
+ $this->assertEquals('enum', $enum['body']['format']);
+ $this->assertEquals('maybe', $enum['body']['default']);
+ $this->assertIsArray($enum['body']['elements']);
+ $this->assertEquals(['yes', 'no', 'maybe'], $enum['body']['elements']);
+
+ $this->assertEquals(202, $ip['headers']['status-code']);
+ $this->assertEquals('ip', $ip['body']['key']);
+ $this->assertEquals('string', $ip['body']['type']);
+ $this->assertEquals(false, $ip['body']['required']);
+ $this->assertEquals(false, $ip['body']['array']);
+ $this->assertEquals('ip', $ip['body']['format']);
+ $this->assertEquals('192.0.2.0', $ip['body']['default']);
+
+ $this->assertEquals(202, $url['headers']['status-code']);
+ $this->assertEquals('url', $url['body']['key']);
+ $this->assertEquals('string', $url['body']['type']);
+ $this->assertEquals(false, $url['body']['required']);
+ $this->assertEquals(false, $url['body']['array']);
+ $this->assertEquals('url', $url['body']['format']);
+ $this->assertEquals('http://example.com', $url['body']['default']);
+
+ $this->assertEquals(202, $integer['headers']['status-code']);
+ $this->assertEquals('integer', $integer['body']['key']);
+ $this->assertEquals('integer', $integer['body']['type']);
+ $this->assertEquals(false, $integer['body']['required']);
+ $this->assertEquals(false, $integer['body']['array']);
+ $this->assertEquals(1, $integer['body']['min']);
+ $this->assertEquals(5, $integer['body']['max']);
+ $this->assertEquals(3, $integer['body']['default']);
+
+ $this->assertEquals(202, $float['headers']['status-code']);
+ $this->assertEquals('float', $float['body']['key']);
+ $this->assertEquals('double', $float['body']['type']);
+ $this->assertEquals(false, $float['body']['required']);
+ $this->assertEquals(false, $float['body']['array']);
+ $this->assertEquals(1.5, $float['body']['min']);
+ $this->assertEquals(5.5, $float['body']['max']);
+ $this->assertEquals(3.5, $float['body']['default']);
+
+ $this->assertEquals(202, $boolean['headers']['status-code']);
+ $this->assertEquals('boolean', $boolean['body']['key']);
+ $this->assertEquals('boolean', $boolean['body']['type']);
+ $this->assertEquals(false, $boolean['body']['required']);
+ $this->assertEquals(false, $boolean['body']['array']);
+ $this->assertEquals(true, $boolean['body']['default']);
+
+ $this->assertEquals(202, $datetime['headers']['status-code']);
+ $this->assertEquals('datetime', $datetime['body']['key']);
+ $this->assertEquals('datetime', $datetime['body']['type']);
+ $this->assertEquals(false, $datetime['body']['required']);
+ $this->assertEquals(false, $datetime['body']['array']);
+ $this->assertEquals(null, $datetime['body']['default']);
+
+ $this->assertEquals(202, $relationship['headers']['status-code']);
+ $this->assertEquals('relationship', $relationship['body']['key']);
+ $this->assertEquals('relationship', $relationship['body']['type']);
+ $this->assertEquals(false, $relationship['body']['required']);
+ $this->assertEquals(false, $relationship['body']['array']);
+ $this->assertEquals($data['actorsId'], $relationship['body']['relatedTable']);
+ $this->assertEquals('oneToMany', $relationship['body']['relationType']);
+ $this->assertEquals(true, $relationship['body']['twoWay']);
+ $this->assertEquals('twoWayKey', $relationship['body']['twoWayKey']);
+
+ $this->assertEquals(202, $strings['headers']['status-code']);
+ $this->assertEquals('names', $strings['body']['key']);
+ $this->assertEquals('string', $strings['body']['type']);
+ $this->assertEquals(false, $strings['body']['required']);
+ $this->assertEquals(true, $strings['body']['array']);
+ $this->assertEquals(null, $strings['body']['default']);
+
+ $this->assertEquals(202, $integers['headers']['status-code']);
+ $this->assertEquals('numbers', $integers['body']['key']);
+ $this->assertEquals('integer', $integers['body']['type']);
+ $this->assertEquals(false, $integers['body']['required']);
+ $this->assertEquals(true, $integers['body']['array']);
+ $this->assertEquals(1, $integers['body']['min']);
+ $this->assertEquals(999, $integers['body']['max']);
+ $this->assertEquals(null, $integers['body']['default']);
+
+ // Wait for database worker to create attributes
+ sleep(5);
+
+ $stringResponse = $this->client->call(Client::METHOD_GET, $columnsPath . '/' . $string['body']['key'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $emailResponse = $this->client->call(Client::METHOD_GET, $columnsPath . '/' . $email['body']['key'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $enumResponse = $this->client->call(Client::METHOD_GET, $columnsPath . '/' . $enum['body']['key'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $ipResponse = $this->client->call(Client::METHOD_GET, $columnsPath . '/' . $ip['body']['key'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $urlResponse = $this->client->call(Client::METHOD_GET, $columnsPath . '/' . $url['body']['key'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $integerResponse = $this->client->call(Client::METHOD_GET, $columnsPath . '/' . $integer['body']['key'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $floatResponse = $this->client->call(Client::METHOD_GET, $columnsPath . '/' . $float['body']['key'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $booleanResponse = $this->client->call(Client::METHOD_GET, $columnsPath . '/' . $boolean['body']['key'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $datetimeResponse = $this->client->call(Client::METHOD_GET, $columnsPath . '/' . $datetime['body']['key'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $relationshipResponse = $this->client->call(Client::METHOD_GET, $columnsPath . '/' . $relationship['body']['key'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $stringsResponse = $this->client->call(Client::METHOD_GET, $columnsPath . '/' . $strings['body']['key'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $integersResponse = $this->client->call(Client::METHOD_GET, $columnsPath . '/' . $integers['body']['key'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals(200, $stringResponse['headers']['status-code']);
+ $this->assertEquals($string['body']['key'], $stringResponse['body']['key']);
+ $this->assertEquals($string['body']['type'], $stringResponse['body']['type']);
+ $this->assertEquals('available', $stringResponse['body']['status']);
+ $this->assertEquals($string['body']['required'], $stringResponse['body']['required']);
+ $this->assertEquals($string['body']['array'], $stringResponse['body']['array']);
+ $this->assertEquals(16, $stringResponse['body']['size']);
+ $this->assertEquals($string['body']['default'], $stringResponse['body']['default']);
+
+ $this->assertEquals(200, $emailResponse['headers']['status-code']);
+ $this->assertEquals($email['body']['key'], $emailResponse['body']['key']);
+ $this->assertEquals($email['body']['type'], $emailResponse['body']['type']);
+ $this->assertEquals('available', $emailResponse['body']['status']);
+ $this->assertEquals($email['body']['required'], $emailResponse['body']['required']);
+ $this->assertEquals($email['body']['array'], $emailResponse['body']['array']);
+ $this->assertEquals($email['body']['format'], $emailResponse['body']['format']);
+ $this->assertEquals($email['body']['default'], $emailResponse['body']['default']);
+
+ $this->assertEquals(200, $enumResponse['headers']['status-code']);
+ $this->assertEquals($enum['body']['key'], $enumResponse['body']['key']);
+ $this->assertEquals($enum['body']['type'], $enumResponse['body']['type']);
+ $this->assertEquals('available', $enumResponse['body']['status']);
+ $this->assertEquals($enum['body']['required'], $enumResponse['body']['required']);
+ $this->assertEquals($enum['body']['array'], $enumResponse['body']['array']);
+ $this->assertEquals($enum['body']['format'], $enumResponse['body']['format']);
+ $this->assertEquals($enum['body']['default'], $enumResponse['body']['default']);
+ $this->assertEquals($enum['body']['elements'], $enumResponse['body']['elements']);
+
+ $this->assertEquals(200, $ipResponse['headers']['status-code']);
+ $this->assertEquals($ip['body']['key'], $ipResponse['body']['key']);
+ $this->assertEquals($ip['body']['type'], $ipResponse['body']['type']);
+ $this->assertEquals('available', $ipResponse['body']['status']);
+ $this->assertEquals($ip['body']['required'], $ipResponse['body']['required']);
+ $this->assertEquals($ip['body']['array'], $ipResponse['body']['array']);
+ $this->assertEquals($ip['body']['format'], $ipResponse['body']['format']);
+ $this->assertEquals($ip['body']['default'], $ipResponse['body']['default']);
+
+ $this->assertEquals(200, $urlResponse['headers']['status-code']);
+ $this->assertEquals($url['body']['key'], $urlResponse['body']['key']);
+ $this->assertEquals($url['body']['type'], $urlResponse['body']['type']);
+ $this->assertEquals('available', $urlResponse['body']['status']);
+ $this->assertEquals($url['body']['required'], $urlResponse['body']['required']);
+ $this->assertEquals($url['body']['array'], $urlResponse['body']['array']);
+ $this->assertEquals($url['body']['format'], $urlResponse['body']['format']);
+ $this->assertEquals($url['body']['default'], $urlResponse['body']['default']);
+
+ $this->assertEquals(200, $integerResponse['headers']['status-code']);
+ $this->assertEquals($integer['body']['key'], $integerResponse['body']['key']);
+ $this->assertEquals($integer['body']['type'], $integerResponse['body']['type']);
+ $this->assertEquals('available', $integerResponse['body']['status']);
+ $this->assertEquals($integer['body']['required'], $integerResponse['body']['required']);
+ $this->assertEquals($integer['body']['array'], $integerResponse['body']['array']);
+ $this->assertEquals($integer['body']['min'], $integerResponse['body']['min']);
+ $this->assertEquals($integer['body']['max'], $integerResponse['body']['max']);
+ $this->assertEquals($integer['body']['default'], $integerResponse['body']['default']);
+
+ $this->assertEquals(200, $floatResponse['headers']['status-code']);
+ $this->assertEquals($float['body']['key'], $floatResponse['body']['key']);
+ $this->assertEquals($float['body']['type'], $floatResponse['body']['type']);
+ $this->assertEquals('available', $floatResponse['body']['status']);
+ $this->assertEquals($float['body']['required'], $floatResponse['body']['required']);
+ $this->assertEquals($float['body']['array'], $floatResponse['body']['array']);
+ $this->assertEquals($float['body']['min'], $floatResponse['body']['min']);
+ $this->assertEquals($float['body']['max'], $floatResponse['body']['max']);
+ $this->assertEquals($float['body']['default'], $floatResponse['body']['default']);
+
+ $this->assertEquals(200, $booleanResponse['headers']['status-code']);
+ $this->assertEquals($boolean['body']['key'], $booleanResponse['body']['key']);
+ $this->assertEquals($boolean['body']['type'], $booleanResponse['body']['type']);
+ $this->assertEquals('available', $booleanResponse['body']['status']);
+ $this->assertEquals($boolean['body']['required'], $booleanResponse['body']['required']);
+ $this->assertEquals($boolean['body']['array'], $booleanResponse['body']['array']);
+ $this->assertEquals($boolean['body']['default'], $booleanResponse['body']['default']);
+
+ $this->assertEquals(200, $datetimeResponse['headers']['status-code']);
+ $this->assertEquals($datetime['body']['key'], $datetimeResponse['body']['key']);
+ $this->assertEquals($datetime['body']['type'], $datetimeResponse['body']['type']);
+ $this->assertEquals('available', $datetimeResponse['body']['status']);
+ $this->assertEquals($datetime['body']['required'], $datetimeResponse['body']['required']);
+ $this->assertEquals($datetime['body']['array'], $datetimeResponse['body']['array']);
+ $this->assertEquals($datetime['body']['default'], $datetimeResponse['body']['default']);
+
+ $this->assertEquals(200, $relationshipResponse['headers']['status-code']);
+ $this->assertEquals($relationship['body']['key'], $relationshipResponse['body']['key']);
+ $this->assertEquals($relationship['body']['type'], $relationshipResponse['body']['type']);
+ $this->assertEquals('available', $relationshipResponse['body']['status']);
+ $this->assertEquals($relationship['body']['required'], $relationshipResponse['body']['required']);
+ $this->assertEquals($relationship['body']['array'], $relationshipResponse['body']['array']);
+ $this->assertEquals($relationship['body']['relatedTable'], $relationshipResponse['body']['relatedTable']);
+ $this->assertEquals($relationship['body']['relationType'], $relationshipResponse['body']['relationType']);
+ $this->assertEquals($relationship['body']['twoWay'], $relationshipResponse['body']['twoWay']);
+ $this->assertEquals($relationship['body']['twoWayKey'], $relationshipResponse['body']['twoWayKey']);
+
+ $columns = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals(200, $columns['headers']['status-code']);
+ $this->assertEquals(12, $columns['body']['total']);
+
+ $columns = $columns['body']['columns'];
+ $this->assertIsArray($columns);
+ $this->assertCount(12, $columns);
+
+ $this->assertEquals($stringResponse['body']['key'], $columns[0]['key']);
+ $this->assertEquals($stringResponse['body']['type'], $columns[0]['type']);
+ $this->assertEquals($stringResponse['body']['status'], $columns[0]['status']);
+ $this->assertEquals($stringResponse['body']['required'], $columns[0]['required']);
+ $this->assertEquals($stringResponse['body']['array'], $columns[0]['array']);
+ $this->assertEquals($stringResponse['body']['size'], $columns[0]['size']);
+ $this->assertEquals($stringResponse['body']['default'], $columns[0]['default']);
+
+ $this->assertEquals($emailResponse['body']['key'], $columns[1]['key']);
+ $this->assertEquals($emailResponse['body']['type'], $columns[1]['type']);
+ $this->assertEquals($emailResponse['body']['status'], $columns[1]['status']);
+ $this->assertEquals($emailResponse['body']['required'], $columns[1]['required']);
+ $this->assertEquals($emailResponse['body']['array'], $columns[1]['array']);
+ $this->assertEquals($emailResponse['body']['default'], $columns[1]['default']);
+ $this->assertEquals($emailResponse['body']['format'], $columns[1]['format']);
+
+ $this->assertEquals($enumResponse['body']['key'], $columns[2]['key']);
+ $this->assertEquals($enumResponse['body']['type'], $columns[2]['type']);
+ $this->assertEquals($enumResponse['body']['status'], $columns[2]['status']);
+ $this->assertEquals($enumResponse['body']['required'], $columns[2]['required']);
+ $this->assertEquals($enumResponse['body']['array'], $columns[2]['array']);
+ $this->assertEquals($enumResponse['body']['default'], $columns[2]['default']);
+ $this->assertEquals($enumResponse['body']['format'], $columns[2]['format']);
+ $this->assertEquals($enumResponse['body']['elements'], $columns[2]['elements']);
+
+ $this->assertEquals($ipResponse['body']['key'], $columns[3]['key']);
+ $this->assertEquals($ipResponse['body']['type'], $columns[3]['type']);
+ $this->assertEquals($ipResponse['body']['status'], $columns[3]['status']);
+ $this->assertEquals($ipResponse['body']['required'], $columns[3]['required']);
+ $this->assertEquals($ipResponse['body']['array'], $columns[3]['array']);
+ $this->assertEquals($ipResponse['body']['default'], $columns[3]['default']);
+ $this->assertEquals($ipResponse['body']['format'], $columns[3]['format']);
+
+ $this->assertEquals($urlResponse['body']['key'], $columns[4]['key']);
+ $this->assertEquals($urlResponse['body']['type'], $columns[4]['type']);
+ $this->assertEquals($urlResponse['body']['status'], $columns[4]['status']);
+ $this->assertEquals($urlResponse['body']['required'], $columns[4]['required']);
+ $this->assertEquals($urlResponse['body']['array'], $columns[4]['array']);
+ $this->assertEquals($urlResponse['body']['default'], $columns[4]['default']);
+ $this->assertEquals($urlResponse['body']['format'], $columns[4]['format']);
+
+ $this->assertEquals($integerResponse['body']['key'], $columns[5]['key']);
+ $this->assertEquals($integerResponse['body']['type'], $columns[5]['type']);
+ $this->assertEquals($integerResponse['body']['status'], $columns[5]['status']);
+ $this->assertEquals($integerResponse['body']['required'], $columns[5]['required']);
+ $this->assertEquals($integerResponse['body']['array'], $columns[5]['array']);
+ $this->assertEquals($integerResponse['body']['default'], $columns[5]['default']);
+ $this->assertEquals($integerResponse['body']['min'], $columns[5]['min']);
+ $this->assertEquals($integerResponse['body']['max'], $columns[5]['max']);
+
+ $this->assertEquals($floatResponse['body']['key'], $columns[6]['key']);
+ $this->assertEquals($floatResponse['body']['type'], $columns[6]['type']);
+ $this->assertEquals($floatResponse['body']['status'], $columns[6]['status']);
+ $this->assertEquals($floatResponse['body']['required'], $columns[6]['required']);
+ $this->assertEquals($floatResponse['body']['array'], $columns[6]['array']);
+ $this->assertEquals($floatResponse['body']['default'], $columns[6]['default']);
+ $this->assertEquals($floatResponse['body']['min'], $columns[6]['min']);
+ $this->assertEquals($floatResponse['body']['max'], $columns[6]['max']);
+
+ $this->assertEquals($booleanResponse['body']['key'], $columns[7]['key']);
+ $this->assertEquals($booleanResponse['body']['type'], $columns[7]['type']);
+ $this->assertEquals($booleanResponse['body']['status'], $columns[7]['status']);
+ $this->assertEquals($booleanResponse['body']['required'], $columns[7]['required']);
+ $this->assertEquals($booleanResponse['body']['array'], $columns[7]['array']);
+ $this->assertEquals($booleanResponse['body']['default'], $columns[7]['default']);
+
+ $this->assertEquals($datetimeResponse['body']['key'], $columns[8]['key']);
+ $this->assertEquals($datetimeResponse['body']['type'], $columns[8]['type']);
+ $this->assertEquals($datetimeResponse['body']['status'], $columns[8]['status']);
+ $this->assertEquals($datetimeResponse['body']['required'], $columns[8]['required']);
+ $this->assertEquals($datetimeResponse['body']['array'], $columns[8]['array']);
+ $this->assertEquals($datetimeResponse['body']['default'], $columns[8]['default']);
+
+ $this->assertEquals($relationshipResponse['body']['key'], $columns[9]['key']);
+ $this->assertEquals($relationshipResponse['body']['type'], $columns[9]['type']);
+ $this->assertEquals($relationshipResponse['body']['status'], $columns[9]['status']);
+ $this->assertEquals($relationshipResponse['body']['required'], $columns[9]['required']);
+ $this->assertEquals($relationshipResponse['body']['array'], $columns[9]['array']);
+ $this->assertEquals($relationshipResponse['body']['relatedTable'], $columns[9]['relatedTable']);
+ $this->assertEquals($relationshipResponse['body']['relationType'], $columns[9]['relationType']);
+ $this->assertEquals($relationshipResponse['body']['twoWay'], $columns[9]['twoWay']);
+ $this->assertEquals($relationshipResponse['body']['twoWayKey'], $columns[9]['twoWayKey']);
+
+ $this->assertEquals($stringsResponse['body']['key'], $columns[10]['key']);
+ $this->assertEquals($stringsResponse['body']['type'], $columns[10]['type']);
+ $this->assertEquals($stringsResponse['body']['status'], $columns[10]['status']);
+ $this->assertEquals($stringsResponse['body']['required'], $columns[10]['required']);
+ $this->assertEquals($stringsResponse['body']['array'], $columns[10]['array']);
+ $this->assertEquals($stringsResponse['body']['default'], $columns[10]['default']);
+
+ $this->assertEquals($integersResponse['body']['key'], $columns[11]['key']);
+ $this->assertEquals($integersResponse['body']['type'], $columns[11]['type']);
+ $this->assertEquals($integersResponse['body']['status'], $columns[11]['status']);
+ $this->assertEquals($integersResponse['body']['required'], $columns[11]['required']);
+ $this->assertEquals($integersResponse['body']['array'], $columns[11]['array']);
+ $this->assertEquals($integersResponse['body']['default'], $columns[11]['default']);
+ $this->assertEquals($integersResponse['body']['min'], $columns[11]['min']);
+ $this->assertEquals($integersResponse['body']['max'], $columns[11]['max']);
+
+ $table = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals(200, $table['headers']['status-code']);
+
+ $columns = $table['body']['columns'];
+
+ $this->assertIsArray($columns);
+ $this->assertCount(12, $columns);
+
+ $this->assertEquals($stringResponse['body']['key'], $columns[0]['key']);
+ $this->assertEquals($stringResponse['body']['type'], $columns[0]['type']);
+ $this->assertEquals($stringResponse['body']['status'], $columns[0]['status']);
+ $this->assertEquals($stringResponse['body']['required'], $columns[0]['required']);
+ $this->assertEquals($stringResponse['body']['array'], $columns[0]['array']);
+ $this->assertEquals($stringResponse['body']['size'], $columns[0]['size']);
+ $this->assertEquals($stringResponse['body']['default'], $columns[0]['default']);
+
+ $this->assertEquals($emailResponse['body']['key'], $columns[1]['key']);
+ $this->assertEquals($emailResponse['body']['type'], $columns[1]['type']);
+ $this->assertEquals($emailResponse['body']['status'], $columns[1]['status']);
+ $this->assertEquals($emailResponse['body']['required'], $columns[1]['required']);
+ $this->assertEquals($emailResponse['body']['array'], $columns[1]['array']);
+ $this->assertEquals($emailResponse['body']['default'], $columns[1]['default']);
+ $this->assertEquals($emailResponse['body']['format'], $columns[1]['format']);
+
+ $this->assertEquals($enumResponse['body']['key'], $columns[2]['key']);
+ $this->assertEquals($enumResponse['body']['type'], $columns[2]['type']);
+ $this->assertEquals($enumResponse['body']['status'], $columns[2]['status']);
+ $this->assertEquals($enumResponse['body']['required'], $columns[2]['required']);
+ $this->assertEquals($enumResponse['body']['array'], $columns[2]['array']);
+ $this->assertEquals($enumResponse['body']['default'], $columns[2]['default']);
+ $this->assertEquals($enumResponse['body']['format'], $columns[2]['format']);
+ $this->assertEquals($enumResponse['body']['elements'], $columns[2]['elements']);
+
+ $this->assertEquals($ipResponse['body']['key'], $columns[3]['key']);
+ $this->assertEquals($ipResponse['body']['type'], $columns[3]['type']);
+ $this->assertEquals($ipResponse['body']['status'], $columns[3]['status']);
+ $this->assertEquals($ipResponse['body']['required'], $columns[3]['required']);
+ $this->assertEquals($ipResponse['body']['array'], $columns[3]['array']);
+ $this->assertEquals($ipResponse['body']['default'], $columns[3]['default']);
+ $this->assertEquals($ipResponse['body']['format'], $columns[3]['format']);
+
+ $this->assertEquals($urlResponse['body']['key'], $columns[4]['key']);
+ $this->assertEquals($urlResponse['body']['type'], $columns[4]['type']);
+ $this->assertEquals($urlResponse['body']['status'], $columns[4]['status']);
+ $this->assertEquals($urlResponse['body']['required'], $columns[4]['required']);
+ $this->assertEquals($urlResponse['body']['array'], $columns[4]['array']);
+ $this->assertEquals($urlResponse['body']['default'], $columns[4]['default']);
+ $this->assertEquals($urlResponse['body']['format'], $columns[4]['format']);
+
+ $this->assertEquals($integerResponse['body']['key'], $columns[5]['key']);
+ $this->assertEquals($integerResponse['body']['type'], $columns[5]['type']);
+ $this->assertEquals($integerResponse['body']['status'], $columns[5]['status']);
+ $this->assertEquals($integerResponse['body']['required'], $columns[5]['required']);
+ $this->assertEquals($integerResponse['body']['array'], $columns[5]['array']);
+ $this->assertEquals($integerResponse['body']['default'], $columns[5]['default']);
+ $this->assertEquals($integerResponse['body']['min'], $columns[5]['min']);
+ $this->assertEquals($integerResponse['body']['max'], $columns[5]['max']);
+
+ $this->assertEquals($floatResponse['body']['key'], $columns[6]['key']);
+ $this->assertEquals($floatResponse['body']['type'], $columns[6]['type']);
+ $this->assertEquals($floatResponse['body']['status'], $columns[6]['status']);
+ $this->assertEquals($floatResponse['body']['required'], $columns[6]['required']);
+ $this->assertEquals($floatResponse['body']['array'], $columns[6]['array']);
+ $this->assertEquals($floatResponse['body']['default'], $columns[6]['default']);
+ $this->assertEquals($floatResponse['body']['min'], $columns[6]['min']);
+ $this->assertEquals($floatResponse['body']['max'], $columns[6]['max']);
+
+ $this->assertEquals($booleanResponse['body']['key'], $columns[7]['key']);
+ $this->assertEquals($booleanResponse['body']['type'], $columns[7]['type']);
+ $this->assertEquals($booleanResponse['body']['status'], $columns[7]['status']);
+ $this->assertEquals($booleanResponse['body']['required'], $columns[7]['required']);
+ $this->assertEquals($booleanResponse['body']['array'], $columns[7]['array']);
+ $this->assertEquals($booleanResponse['body']['default'], $columns[7]['default']);
+
+ $this->assertEquals($datetimeResponse['body']['key'], $columns[8]['key']);
+ $this->assertEquals($datetimeResponse['body']['type'], $columns[8]['type']);
+ $this->assertEquals($datetimeResponse['body']['status'], $columns[8]['status']);
+ $this->assertEquals($datetimeResponse['body']['required'], $columns[8]['required']);
+ $this->assertEquals($datetimeResponse['body']['array'], $columns[8]['array']);
+ $this->assertEquals($datetimeResponse['body']['default'], $columns[8]['default']);
+
+ $this->assertEquals($relationshipResponse['body']['key'], $columns[9]['key']);
+ $this->assertEquals($relationshipResponse['body']['type'], $columns[9]['type']);
+ $this->assertEquals($relationshipResponse['body']['status'], $columns[9]['status']);
+ $this->assertEquals($relationshipResponse['body']['required'], $columns[9]['required']);
+ $this->assertEquals($relationshipResponse['body']['array'], $columns[9]['array']);
+ $this->assertEquals($relationshipResponse['body']['relatedTable'], $columns[9]['relatedTable']);
+ $this->assertEquals($relationshipResponse['body']['relationType'], $columns[9]['relationType']);
+ $this->assertEquals($relationshipResponse['body']['twoWay'], $columns[9]['twoWay']);
+ $this->assertEquals($relationshipResponse['body']['twoWayKey'], $columns[9]['twoWayKey']);
+
+ $this->assertEquals($stringsResponse['body']['key'], $columns[10]['key']);
+ $this->assertEquals($stringsResponse['body']['type'], $columns[10]['type']);
+ $this->assertEquals($stringsResponse['body']['status'], $columns[10]['status']);
+ $this->assertEquals($stringsResponse['body']['required'], $columns[10]['required']);
+ $this->assertEquals($stringsResponse['body']['array'], $columns[10]['array']);
+ $this->assertEquals($stringsResponse['body']['default'], $columns[10]['default']);
+
+ $this->assertEquals($integersResponse['body']['key'], $columns[11]['key']);
+ $this->assertEquals($integersResponse['body']['type'], $columns[11]['type']);
+ $this->assertEquals($integersResponse['body']['status'], $columns[11]['status']);
+ $this->assertEquals($integersResponse['body']['required'], $columns[11]['required']);
+ $this->assertEquals($integersResponse['body']['array'], $columns[11]['array']);
+ $this->assertEquals($integersResponse['body']['default'], $columns[11]['default']);
+ $this->assertEquals($integersResponse['body']['min'], $columns[11]['min']);
+ $this->assertEquals($integersResponse['body']['max'], $columns[11]['max']);
+
+ /**
+ * Test for FAILURE
+ */
+ $badEnum = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/enum', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'enum',
+ 'elements' => ['yes', 'no', ''],
+ 'required' => false,
+ 'default' => 'maybe',
+ ]);
+
+ $this->assertEquals(400, $badEnum['headers']['status-code']);
+ $this->assertEquals('Invalid `elements` param: Value must a valid array no longer than 100 items and Value must be a valid string and at least 1 chars and no longer than 255 chars', $badEnum['body']['message']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateColumns
+ */
+ public function testCreateIndexes(array $data): array
+ {
+ $databaseId = $data['databaseId'];
+
+ $titleIndex = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'titleIndex',
+ 'type' => 'fulltext',
+ 'columns' => ['title'],
+ ]);
+
+ $this->assertEquals(202, $titleIndex['headers']['status-code']);
+ $this->assertEquals('titleIndex', $titleIndex['body']['key']);
+ $this->assertEquals('fulltext', $titleIndex['body']['type']);
+ $this->assertCount(1, $titleIndex['body']['columns']);
+ $this->assertEquals('title', $titleIndex['body']['columns'][0]);
+
+ $releaseYearIndex = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'releaseYear',
+ 'type' => 'key',
+ 'columns' => ['releaseYear'],
+ ]);
+
+ $this->assertEquals(202, $releaseYearIndex['headers']['status-code']);
+ $this->assertEquals('releaseYear', $releaseYearIndex['body']['key']);
+ $this->assertEquals('key', $releaseYearIndex['body']['type']);
+ $this->assertCount(1, $releaseYearIndex['body']['columns']);
+ $this->assertEquals('releaseYear', $releaseYearIndex['body']['columns'][0]);
+
+ $releaseWithDate1 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'releaseYearDated',
+ 'type' => 'key',
+ 'columns' => ['releaseYear', '$createdAt', '$updatedAt'],
+ ]);
+
+ $this->assertEquals(202, $releaseWithDate1['headers']['status-code']);
+ $this->assertEquals('releaseYearDated', $releaseWithDate1['body']['key']);
+ $this->assertEquals('key', $releaseWithDate1['body']['type']);
+ $this->assertCount(3, $releaseWithDate1['body']['columns']);
+ $this->assertEquals('releaseYear', $releaseWithDate1['body']['columns'][0]);
+ $this->assertEquals('$createdAt', $releaseWithDate1['body']['columns'][1]);
+ $this->assertEquals('$updatedAt', $releaseWithDate1['body']['columns'][2]);
+
+ $releaseWithDate2 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'birthDay',
+ 'type' => 'key',
+ 'columns' => ['birthDay'],
+ ]);
+
+ $this->assertEquals(202, $releaseWithDate2['headers']['status-code']);
+ $this->assertEquals('birthDay', $releaseWithDate2['body']['key']);
+ $this->assertEquals('key', $releaseWithDate2['body']['type']);
+ $this->assertCount(1, $releaseWithDate2['body']['columns']);
+ $this->assertEquals('birthDay', $releaseWithDate2['body']['columns'][0]);
+
+ // Test for failure
+ $fulltextReleaseYear = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'releaseYearDated',
+ 'type' => 'fulltext',
+ 'columns' => ['releaseYear'],
+ ]);
+
+ $this->assertEquals(400, $fulltextReleaseYear['headers']['status-code']);
+ $this->assertEquals($fulltextReleaseYear['body']['message'], 'Attribute "releaseYear" cannot be part of a FULLTEXT index, must be of type string');
+
+ $noAttributes = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'none',
+ 'type' => 'key',
+ 'columns' => [],
+ ]);
+
+ $this->assertEquals(400, $noAttributes['headers']['status-code']);
+ $this->assertEquals($noAttributes['body']['message'], 'No attributes provided for index');
+
+ $duplicates = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'duplicate',
+ 'type' => 'fulltext',
+ 'columns' => ['releaseYear', 'releaseYear'],
+ ]);
+
+ $this->assertEquals(400, $duplicates['headers']['status-code']);
+ $this->assertEquals($duplicates['body']['message'], 'Duplicate attributes provided');
+
+ $tooLong = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ]), [
+ 'key' => 'tooLong',
+ 'type' => 'key',
+ 'columns' => ['description', 'tagline'],
+ ]);
+
+ $this->assertEquals(400, $tooLong['headers']['status-code']);
+ $this->assertStringContainsString('Index length is longer than the maximum', $tooLong['body']['message']);
+
+ $fulltextArray = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ]), [
+ 'key' => 'ft',
+ 'type' => 'fulltext',
+ 'columns' => ['actors'],
+ ]);
+
+ $this->assertEquals(400, $fulltextArray['headers']['status-code']);
+ $this->assertEquals('"Fulltext" index is forbidden on array attributes', $fulltextArray['body']['message']);
+
+ $actorsArray = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ]), [
+ 'key' => 'index-actors',
+ 'type' => 'key',
+ 'columns' => ['actors'],
+ ]);
+
+ $this->assertEquals(202, $actorsArray['headers']['status-code']);
+
+ $twoLevelsArray = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ]), [
+ 'key' => 'index-ip-actors',
+ 'type' => 'key',
+ 'columns' => ['releaseYear', 'actors'], // 2 levels
+ 'orders' => ['DESC', 'DESC'],
+ ]);
+
+ $this->assertEquals(202, $twoLevelsArray['headers']['status-code']);
+ $this->assertEquals('DESC', $twoLevelsArray['body']['orders'][0]);
+ $this->assertEquals(null, $twoLevelsArray['body']['orders'][1]); // Overwrite by API (array)
+
+ $unknown = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ]), [
+ 'key' => 'index-unknown',
+ 'type' => 'key',
+ 'columns' => ['Unknown'],
+ ]);
+
+ $this->assertEquals(400, $unknown['headers']['status-code']);
+ $this->assertEquals('Unknown column: Unknown. Verify the column name or create the column.', $unknown['body']['message']);
+
+ $index1 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ]), [
+ 'key' => 'integers-order',
+ 'type' => 'key',
+ 'columns' => ['integers'], // array attribute
+ 'orders' => ['DESC'], // Check order is removed in API
+ ]);
+ $this->assertEquals(202, $index1['headers']['status-code']);
+
+ $index2 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ]), [
+ 'key' => 'integers-size',
+ 'type' => 'key',
+ 'columns' => ['integers'], // array attribute
+ ]);
+ $this->assertEquals(202, $index2['headers']['status-code']);
+
+ /**
+ * Create Indexes by worker
+ */
+ sleep(2);
+
+ $movies = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), []);
+
+ $this->assertIsArray($movies['body']['indexes']);
+ $this->assertCount(8, $movies['body']['indexes']);
+ $this->assertEquals($titleIndex['body']['key'], $movies['body']['indexes'][0]['key']);
+ $this->assertEquals($releaseYearIndex['body']['key'], $movies['body']['indexes'][1]['key']);
+ $this->assertEquals($releaseWithDate1['body']['key'], $movies['body']['indexes'][2]['key']);
+ $this->assertEquals($releaseWithDate2['body']['key'], $movies['body']['indexes'][3]['key']);
+ foreach ($movies['body']['indexes'] as $index) {
+ $this->assertEquals('available', $index['status']);
+ }
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateColumns
+ */
+ public function testGetIndexByKeyWithLengths(array $data): void
+ {
+ $databaseId = $data['databaseId'];
+ $tableId = $data['moviesId'];
+
+ // Test case for valid lengths
+ $create = $this->client->call(Client::METHOD_POST, "/databases/{$databaseId}/tables/{$tableId}/indexes", [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], [
+ 'key' => 'lengthTestIndex',
+ 'type' => 'key',
+ 'columns' => ['title','description'],
+ 'lengths' => [128,200]
+ ]);
+ $this->assertEquals(202, $create['headers']['status-code']);
+
+ // Fetch index and check correct lengths
+ $index = $this->client->call(Client::METHOD_GET, "/databases/{$databaseId}/tables/{$tableId}/indexes/lengthTestIndex", [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]);
+ $this->assertEquals(200, $index['headers']['status-code']);
+ $this->assertEquals('lengthTestIndex', $index['body']['key']);
+ $this->assertEquals([128, 200], $index['body']['lengths']);
+
+ // Test case for lengths array overriding
+ // set a length for an array attribute, it should get overriden with Database::ARRAY_INDEX_LENGTH
+ $create = $this->client->call(Client::METHOD_POST, "/databases/{$databaseId}/tables/{$tableId}/indexes", [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], [
+ 'key' => 'lengthOverrideTestIndex',
+ 'type' => 'key',
+ 'columns' => ['actors'],
+ 'lengths' => [120]
+ ]);
+ $this->assertEquals(202, $create['headers']['status-code']);
+
+ $index = $this->client->call(Client::METHOD_GET, "/databases/{$databaseId}/tables/{$tableId}/indexes/lengthOverrideTestIndex", [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]);
+ $this->assertEquals([Database::ARRAY_INDEX_LENGTH], $index['body']['lengths']);
+
+ // Test case for count of lengths greater than attributes (should throw 400)
+ $create = $this->client->call(Client::METHOD_POST, "/databases/{$databaseId}/tables/{$tableId}/indexes", [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], [
+ 'key' => 'lengthCountExceededIndex',
+ 'type' => 'key',
+ 'columns' => ['title'],
+ 'lengths' => [128, 128]
+ ]);
+ $this->assertEquals(400, $create['headers']['status-code']);
+
+ // Test case for lengths exceeding total of 768
+ $create = $this->client->call(Client::METHOD_POST, "/databases/{$databaseId}/tables/{$tableId}/indexes", [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], [
+ 'key' => 'lengthTooLargeIndex',
+ 'type' => 'key',
+ 'columns' => ['title','description','tagline','actors'],
+ 'lengths' => [256,256,256,20]
+ ]);
+
+ $this->assertEquals(400, $create['headers']['status-code']);
+
+ // Test case for negative length values
+ $create = $this->client->call(Client::METHOD_POST, "/databases/{$databaseId}/tables/{$tableId}/indexes", [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], [
+ 'key' => 'negativeLengthIndex',
+ 'type' => 'key',
+ 'columns' => ['title'],
+ 'lengths' => [-1]
+ ]);
+ $this->assertEquals(400, $create['headers']['status-code']);
+ }
+
+ /**
+ * @depends testCreateIndexes
+ */
+ public function testListIndexes(array $data): void
+ {
+ $databaseId = $data['databaseId'];
+ $response = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ]), [
+ 'queries' => [
+ Query::equal('type', ['key'])->toString(),
+ Query::limit(2)->toString()
+ ],
+ ]);
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertEquals(2, \count($response['body']['indexes']));
+ $response = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ]), [
+ 'queries' => [
+ Query::select(['key'])->toString(),
+ ],
+ ]);
+ $this->assertEquals(Exception::GENERAL_ARGUMENT_INVALID, $response['body']['type']);
+ $this->assertEquals(400, $response['headers']['status-code']);
+ }
+
+ /**
+ * @depends testCreateIndexes
+ */
+ public function testCreateRow(array $data): array
+ {
+ $databaseId = $data['databaseId'];
+ $row1 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Captain America',
+ 'releaseYear' => 1944,
+ 'birthDay' => '1975-06-12 14:12:55+02:00',
+ 'actors' => [
+ 'Chris Evans',
+ 'Samuel Jackson',
+ ]
+ ],
+ 'permissions' => [
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::delete(Role::user($this->getUser()['$id'])),
+ ]
+ ]);
+
+ $row2 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Spider-Man: Far From Home',
+ 'releaseYear' => 2019,
+ 'birthDay' => null,
+ 'actors' => [
+ 'Tom Holland',
+ 'Zendaya Maree Stoermer',
+ 'Samuel Jackson',
+ ],
+ 'integers' => [50,60]
+ ],
+ 'permissions' => [
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::delete(Role::user($this->getUser()['$id'])),
+ ]
+ ]);
+
+ $row3 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Spider-Man: Homecoming',
+ 'releaseYear' => 2017,
+ 'birthDay' => '1975-06-12 14:12:55 America/New_York',
+ 'duration' => 65,
+ 'actors' => [
+ 'Tom Holland',
+ 'Zendaya Maree Stoermer',
+ ],
+ 'integers' => [50]
+ ],
+ 'permissions' => [
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::delete(Role::user($this->getUser()['$id'])),
+ ]
+ ]);
+
+ $row4 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'releaseYear' => 2020, // Missing title, expect an 400 error
+ ],
+ 'permissions' => [
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::delete(Role::user($this->getUser()['$id'])),
+ ]
+ ]);
+
+ $this->assertEquals(201, $row1['headers']['status-code']);
+ $this->assertEquals($data['moviesId'], $row1['body']['$tableId']);
+ $this->assertArrayNotHasKey('$table', $row1['body']);
+ $this->assertEquals($databaseId, $row1['body']['$databaseId']);
+ $this->assertEquals($row1['body']['title'], 'Captain America');
+ $this->assertEquals($row1['body']['releaseYear'], 1944);
+ $this->assertIsArray($row1['body']['$permissions']);
+ $this->assertCount(3, $row1['body']['$permissions']);
+ $this->assertCount(2, $row1['body']['actors']);
+ $this->assertEquals($row1['body']['actors'][0], 'Chris Evans');
+ $this->assertEquals($row1['body']['actors'][1], 'Samuel Jackson');
+ $this->assertEquals($row1['body']['birthDay'], '1975-06-12T12:12:55.000+00:00');
+
+ $this->assertEquals(201, $row2['headers']['status-code']);
+ $this->assertEquals($data['moviesId'], $row2['body']['$tableId']);
+ $this->assertArrayNotHasKey('$table', $row2['body']);
+ $this->assertEquals($databaseId, $row2['body']['$databaseId']);
+ $this->assertEquals($row2['body']['title'], 'Spider-Man: Far From Home');
+ $this->assertEquals($row2['body']['releaseYear'], 2019);
+ $this->assertEquals($row2['body']['duration'], null);
+ $this->assertIsArray($row2['body']['$permissions']);
+ $this->assertCount(3, $row2['body']['$permissions']);
+ $this->assertCount(3, $row2['body']['actors']);
+ $this->assertEquals($row2['body']['actors'][0], 'Tom Holland');
+ $this->assertEquals($row2['body']['actors'][1], 'Zendaya Maree Stoermer');
+ $this->assertEquals($row2['body']['actors'][2], 'Samuel Jackson');
+ $this->assertEquals($row2['body']['birthDay'], null);
+ $this->assertEquals($row2['body']['integers'][0], 50);
+ $this->assertEquals($row2['body']['integers'][1], 60);
+
+ $this->assertEquals(201, $row3['headers']['status-code']);
+ $this->assertEquals($data['moviesId'], $row3['body']['$tableId']);
+ $this->assertArrayNotHasKey('$table', $row3['body']);
+ $this->assertEquals($databaseId, $row3['body']['$databaseId']);
+ $this->assertEquals($row3['body']['title'], 'Spider-Man: Homecoming');
+ $this->assertEquals($row3['body']['releaseYear'], 2017);
+ $this->assertEquals($row3['body']['duration'], 65);
+ $this->assertIsArray($row3['body']['$permissions']);
+ $this->assertCount(3, $row3['body']['$permissions']);
+ $this->assertCount(2, $row3['body']['actors']);
+ $this->assertEquals($row3['body']['actors'][0], 'Tom Holland');
+ $this->assertEquals($row3['body']['actors'][1], 'Zendaya Maree Stoermer');
+ $this->assertEquals($row3['body']['birthDay'], '1975-06-12T18:12:55.000+00:00'); // UTC for NY
+
+ $this->assertEquals(400, $row4['headers']['status-code']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateIndexes
+ */
+ public function testUpsertRow(array $data): void
+ {
+ $databaseId = $data['databaseId'];
+ $rowId = ID::unique();
+ $row = $this->client->call(Client::METHOD_PUT, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows/' . $rowId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'title' => 'Thor: Ragnarok',
+ 'releaseYear' => 2000
+ ],
+ 'permissions' => [
+ Permission::read(Role::users()),
+ Permission::update(Role::users()),
+ Permission::delete(Role::users()),
+ ],
+ ]);
+
+ $this->assertEquals(200, $row['headers']['status-code']);
+ $this->assertCount(3, $row['body']['$permissions']);
+ $row = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows/' . $rowId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals('Thor: Ragnarok', $row['body']['title']);
+
+ $row = $this->client->call(Client::METHOD_PUT, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows/' . $rowId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'title' => 'Thor: Love and Thunder',
+ 'releaseYear' => 2000
+ ],
+ 'permissions' => [
+ Permission::read(Role::users()),
+ Permission::update(Role::users()),
+ Permission::delete(Role::users()),
+ ],
+ ]);
+
+ $this->assertEquals(200, $row['headers']['status-code']);
+ $this->assertEquals('Thor: Love and Thunder', $row['body']['title']);
+
+ $row = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows/' . $rowId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals('Thor: Love and Thunder', $row['body']['title']);
+
+ // removing permission to read and delete
+ $row = $this->client->call(Client::METHOD_PUT, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows/' . $rowId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'title' => 'Thor: Love and Thunder',
+ 'releaseYear' => 2000
+ ],
+ 'permissions' => [
+ Permission::update(Role::users())
+ ],
+ ]);
+ // shouldn't be able to read as no read permission
+ $row = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows/' . $rowId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+ switch ($this->getSide()) {
+ case 'client':
+ $this->assertEquals(404, $row['headers']['status-code']);
+ break;
+ case 'server':
+ $this->assertEquals(200, $row['headers']['status-code']);
+ break;
+ }
+ // shouldn't be able to delete as no delete permission
+ $row = $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows/' . $rowId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+ // simulating for the client
+ // the row should not be allowed to be deleted as needed downward
+ if ($this->getSide() === 'client') {
+ $this->assertEquals(401, $row['headers']['status-code']);
+ }
+ // giving the delete permission
+ $row = $this->client->call(Client::METHOD_PUT, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows/' . $rowId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'title' => 'Thor: Love and Thunder',
+ 'releaseYear' => 2000
+ ],
+ 'permissions' => [
+ Permission::read(Role::users()),
+ Permission::update(Role::users()),
+ Permission::delete(Role::users())
+ ],
+ ]);
+
+ $row = $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows/' . $rowId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+ $this->assertEquals(204, $row['headers']['status-code']);
+
+ // relationship behaviour
+ $person = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => 'person-upsert',
+ 'name' => 'person',
+ 'permissions' => [
+ Permission::read(Role::users()),
+ Permission::update(Role::users()),
+ Permission::delete(Role::users()),
+ Permission::create(Role::users()),
+ ],
+ 'rowSecurity' => true,
+ ]);
+
+ $this->assertEquals(201, $person['headers']['status-code']);
+
+ $library = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => 'library-upsert',
+ 'name' => 'library',
+ 'permissions' => [
+ Permission::read(Role::users()),
+ Permission::update(Role::users()),
+ Permission::create(Role::users()),
+ Permission::delete(Role::users()),
+ ],
+ 'rowSecurity' => true,
+ ]);
+
+ $this->assertEquals(201, $library['headers']['status-code']);
+
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $person['body']['$id'] . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'fullName',
+ 'size' => 255,
+ 'required' => false,
+ ]);
+
+ sleep(1); // Wait for worker
+
+ $relation = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $person['body']['$id'] . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'relatedTableId' => 'library-upsert',
+ 'type' => Database::RELATION_ONE_TO_ONE,
+ 'key' => 'library',
+ 'twoWay' => true,
+ 'onDelete' => Database::RELATION_MUTATE_CASCADE,
+ ]);
+
+ sleep(1); // Wait for worker
+
+ $libraryName = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $library['body']['$id'] . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'libraryName',
+ 'size' => 255,
+ 'required' => true,
+ ]);
+
+ sleep(1); // Wait for worker
+
+ $this->assertEquals(202, $libraryName['headers']['status-code']);
+
+ // upserting values
+ $rowId = ID::unique();
+ $person1 = $this->client->call(Client::METHOD_PUT, '/databases/' . $databaseId . '/tables/' . $person['body']['$id'] . '/rows/'.$rowId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'library' => [
+ '$id' => 'library1',
+ '$permissions' => [
+ Permission::read(Role::users()),
+ Permission::update(Role::users()),
+ Permission::delete(Role::users()),
+ ],
+ 'libraryName' => 'Library 1',
+ ],
+ ],
+ 'permissions' => [
+ Permission::read(Role::users()),
+ Permission::update(Role::users()),
+ Permission::delete(Role::users()),
+ ]
+ ]);
+
+ $this->assertEquals('Library 1', $person1['body']['library']['libraryName']);
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $person['body']['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::select(['fullName', 'library.*'])->toString(),
+ Query::equal('library', ['library1'])->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(1, $rows['body']['total']);
+ $this->assertEquals('Library 1', $rows['body']['rows'][0]['library']['libraryName']);
+
+
+ $person1 = $this->client->call(Client::METHOD_PUT, '/databases/' . $databaseId . '/tables/' . $person['body']['$id'] . '/rows/'.$rowId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'library' => [
+ '$id' => 'library1',
+ '$permissions' => [
+ Permission::read(Role::users()),
+ Permission::update(Role::users()),
+ Permission::delete(Role::users()),
+ ],
+ 'libraryName' => 'Library 2',
+ ],
+ ],
+ 'permissions' => [
+ Permission::read(Role::users()),
+ Permission::update(Role::users()),
+ Permission::delete(Role::users()),
+ ]
+ ]);
+
+ // data should get updated
+ $this->assertEquals('Library 2', $person1['body']['library']['libraryName']);
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $person['body']['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::select(['fullName', 'library.*'])->toString(),
+ Query::equal('library', ['library1'])->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(1, $rows['body']['total']);
+ $this->assertEquals('Library 2', $rows['body']['rows'][0]['library']['libraryName']);
+
+ // data should get added
+ $person1 = $this->client->call(Client::METHOD_PUT, '/databases/' . $databaseId . '/tables/' . $person['body']['$id'] . '/rows/'.ID::unique(), array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'library' => [
+ '$id' => 'library2',
+ '$permissions' => [
+ Permission::read(Role::users()),
+ Permission::update(Role::users()),
+ Permission::delete(Role::users()),
+ ],
+ 'libraryName' => 'Library 2',
+ ],
+ ],
+ 'permissions' => [
+ Permission::read(Role::users()),
+ Permission::update(Role::users()),
+ Permission::delete(Role::users()),
+ ]
+ ]);
+
+ $this->assertEquals('Library 2', $person1['body']['library']['libraryName']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $person['body']['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::select(['fullName', 'library.*'])->toString()
+ ],
+ ]);
+
+ $this->assertEquals(2, $rows['body']['total']);
+ }
+
+ /**
+ * @depends testCreateRow
+ */
+ public function testListRows(array $data): array
+ {
+ $databaseId = $data['databaseId'];
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::orderAsc('releaseYear')->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(1944, $rows['body']['rows'][0]['releaseYear']);
+ $this->assertEquals(2017, $rows['body']['rows'][1]['releaseYear']);
+ $this->assertEquals(2019, $rows['body']['rows'][2]['releaseYear']);
+ $this->assertFalse(array_key_exists('$internalId', $rows['body']['rows'][0]));
+ $this->assertFalse(array_key_exists('$internalId', $rows['body']['rows'][1]));
+ $this->assertFalse(array_key_exists('$internalId', $rows['body']['rows'][2]));
+ $this->assertCount(3, $rows['body']['rows']);
+
+ foreach ($rows['body']['rows'] as $row) {
+ $this->assertArrayNotHasKey('$table', $row);
+ $this->assertEquals($databaseId, $row['$databaseId']);
+ $this->assertEquals($data['moviesId'], $row['$tableId']);
+ }
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::orderDesc('releaseYear')->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(1944, $rows['body']['rows'][2]['releaseYear']);
+ $this->assertEquals(2017, $rows['body']['rows'][1]['releaseYear']);
+ $this->assertEquals(2019, $rows['body']['rows'][0]['releaseYear']);
+ $this->assertCount(3, $rows['body']['rows']);
+
+ // changing description attribute to be null by default instead of empty string
+ $patchNull = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/columns/string/description', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'default' => null,
+ 'required' => false,
+ ]);
+
+ // creating a dummy doc with null description
+ $row1 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Dummy',
+ 'releaseYear' => 1944,
+ 'birthDay' => '1975-06-12 14:12:55+02:00',
+ 'actors' => [
+ 'Dummy',
+ ],
+ ]
+ ]);
+
+ $this->assertEquals(201, $row1['headers']['status-code']);
+ // fetching docs with cursor after the dummy doc with order attr description which is null
+ $rowsPaginated = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::orderAsc('dummy')->toString(),
+ Query::cursorAfter(new Document(['$id' => $row1['body']['$id']]))->toString()
+ ],
+ ]);
+ // should throw 400 as the order attr description of the selected doc is null
+ $this->assertEquals(400, $rowsPaginated['headers']['status-code']);
+
+ // deleting the dummy doc created
+ $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows/' . $row1['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+ return ['rows' => $rows['body']['rows'], 'databaseId' => $databaseId];
+ }
+
+ /**
+ * @depends testListRows
+ */
+ public function testGetRow(array $data): void
+ {
+ $databaseId = $data['databaseId'];
+ foreach ($data['rows'] as $row) {
+ $response = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $row['$tableId'] . '/rows/' . $row['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertEquals($response['body']['$id'], $row['$id']);
+ $this->assertEquals($row['$tableId'], $response['body']['$tableId']);
+ $this->assertArrayNotHasKey('$table', $response['body']);
+ $this->assertEquals($row['$databaseId'], $response['body']['$databaseId']);
+ $this->assertEquals($response['body']['title'], $row['title']);
+ $this->assertEquals($response['body']['releaseYear'], $row['releaseYear']);
+ $this->assertEquals($response['body']['$permissions'], $row['$permissions']);
+ $this->assertEquals($response['body']['birthDay'], $row['birthDay']);
+ $this->assertFalse(array_key_exists('$internalId', $response['body']));
+ $this->assertFalse(array_key_exists('$tenant', $response['body']));
+ }
+ }
+
+ /**
+ * @depends testListRows
+ */
+ public function testGetRowWithQueries(array $data): void
+ {
+ $databaseId = $data['databaseId'];
+ $row = $data['rows'][0];
+
+ $response = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $row['$tableId'] . '/rows/' . $row['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::select(['title', 'releaseYear', '$id'])->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertEquals($row['title'], $response['body']['title']);
+ $this->assertEquals($row['releaseYear'], $response['body']['releaseYear']);
+ $this->assertArrayNotHasKey('birthDay', $response['body']);
+ }
+
+ /**
+ * @depends testCreateRow
+ */
+ public function testListRowsAfterPagination(array $data): array
+ {
+ $databaseId = $data['databaseId'];
+ /**
+ * Test after without order.
+ */
+ $base = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $base['headers']['status-code']);
+ $this->assertEquals('Captain America', $base['body']['rows'][0]['title']);
+ $this->assertEquals('Spider-Man: Far From Home', $base['body']['rows'][1]['title']);
+ $this->assertEquals('Spider-Man: Homecoming', $base['body']['rows'][2]['title']);
+ $this->assertCount(3, $base['body']['rows']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::cursorAfter(new Document(['$id' => $base['body']['rows'][0]['$id']]))->toString()
+ ],
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals($base['body']['rows'][1]['$id'], $rows['body']['rows'][0]['$id']);
+ $this->assertEquals($base['body']['rows'][2]['$id'], $rows['body']['rows'][1]['$id']);
+ $this->assertCount(2, $rows['body']['rows']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::cursorAfter(new Document(['$id' => $base['body']['rows'][2]['$id']]))->toString()
+ ],
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEmpty($rows['body']['rows']);
+
+ /**
+ * Test with ASC order and after.
+ */
+ $base = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::orderAsc('releaseYear')->toString()
+ ],
+ ]);
+
+ $this->assertEquals(200, $base['headers']['status-code']);
+ $this->assertEquals(1944, $base['body']['rows'][0]['releaseYear']);
+ $this->assertEquals(2017, $base['body']['rows'][1]['releaseYear']);
+ $this->assertEquals(2019, $base['body']['rows'][2]['releaseYear']);
+ $this->assertCount(3, $base['body']['rows']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::cursorAfter(new Document(['$id' => $base['body']['rows'][1]['$id']]))->toString(),
+ Query::orderAsc('releaseYear')->toString()
+ ],
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals($base['body']['rows'][2]['$id'], $rows['body']['rows'][0]['$id']);
+ $this->assertCount(1, $rows['body']['rows']);
+
+ /**
+ * Test with DESC order and after.
+ */
+ $base = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::orderDesc('releaseYear')->toString()
+ ],
+ ]);
+
+ $this->assertEquals(200, $base['headers']['status-code']);
+ $this->assertEquals(1944, $base['body']['rows'][2]['releaseYear']);
+ $this->assertEquals(2017, $base['body']['rows'][1]['releaseYear']);
+ $this->assertEquals(2019, $base['body']['rows'][0]['releaseYear']);
+ $this->assertCount(3, $base['body']['rows']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::cursorAfter(new Document(['$id' => $base['body']['rows'][1]['$id']]))->toString(),
+ Query::orderDesc('releaseYear')->toString()
+ ],
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals($base['body']['rows'][2]['$id'], $rows['body']['rows'][0]['$id']);
+ $this->assertCount(1, $rows['body']['rows']);
+
+ /**
+ * Test after with unknown row.
+ */
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::cursorAfter(new Document(['$id' => 'unknown']))->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(400, $rows['headers']['status-code']);
+
+ /**
+ * Test null value for cursor
+ */
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ '{"method":"cursorAfter","values":[null]}',
+ ],
+ ]);
+
+ $this->assertEquals(400, $rows['headers']['status-code']);
+
+ return [];
+ }
+
+ /**
+ * @depends testCreateRow
+ */
+ public function testListRowsBeforePagination(array $data): array
+ {
+ $databaseId = $data['databaseId'];
+ /**
+ * Test before without order.
+ */
+ $base = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $base['headers']['status-code']);
+ $this->assertEquals('Captain America', $base['body']['rows'][0]['title']);
+ $this->assertEquals('Spider-Man: Far From Home', $base['body']['rows'][1]['title']);
+ $this->assertEquals('Spider-Man: Homecoming', $base['body']['rows'][2]['title']);
+ $this->assertCount(3, $base['body']['rows']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::cursorBefore(new Document(['$id' => $base['body']['rows'][2]['$id']]))->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals($base['body']['rows'][0]['$id'], $rows['body']['rows'][0]['$id']);
+ $this->assertEquals($base['body']['rows'][1]['$id'], $rows['body']['rows'][1]['$id']);
+ $this->assertCount(2, $rows['body']['rows']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::cursorBefore(new Document(['$id' => $base['body']['rows'][0]['$id']]))->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEmpty($rows['body']['rows']);
+
+ /**
+ * Test with ASC order and after.
+ */
+ $base = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::orderAsc('releaseYear')->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $base['headers']['status-code']);
+ $this->assertEquals(1944, $base['body']['rows'][0]['releaseYear']);
+ $this->assertEquals(2017, $base['body']['rows'][1]['releaseYear']);
+ $this->assertEquals(2019, $base['body']['rows'][2]['releaseYear']);
+ $this->assertCount(3, $base['body']['rows']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::cursorBefore(new Document(['$id' => $base['body']['rows'][1]['$id']]))->toString(),
+ Query::orderAsc('releaseYear')->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals($base['body']['rows'][0]['$id'], $rows['body']['rows'][0]['$id']);
+ $this->assertCount(1, $rows['body']['rows']);
+
+ /**
+ * Test with DESC order and after.
+ */
+ $base = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::orderDesc('releaseYear')->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $base['headers']['status-code']);
+ $this->assertEquals(1944, $base['body']['rows'][2]['releaseYear']);
+ $this->assertEquals(2017, $base['body']['rows'][1]['releaseYear']);
+ $this->assertEquals(2019, $base['body']['rows'][0]['releaseYear']);
+ $this->assertCount(3, $base['body']['rows']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::cursorBefore(new Document(['$id' => $base['body']['rows'][1]['$id']]))->toString(),
+ Query::orderDesc('releaseYear')->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals($base['body']['rows'][0]['$id'], $rows['body']['rows'][0]['$id']);
+ $this->assertCount(1, $rows['body']['rows']);
+
+ return [];
+ }
+
+ /**
+ * @depends testCreateRow
+ */
+ public function testListRowsLimitAndOffset(array $data): array
+ {
+ $databaseId = $data['databaseId'];
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::orderAsc('releaseYear')->toString(),
+ Query::limit(1)->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(1944, $rows['body']['rows'][0]['releaseYear']);
+ $this->assertCount(1, $rows['body']['rows']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::orderAsc('releaseYear')->toString(),
+ Query::limit(2)->toString(),
+ Query::offset(1)->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(2017, $rows['body']['rows'][0]['releaseYear']);
+ $this->assertEquals(2019, $rows['body']['rows'][1]['releaseYear']);
+ $this->assertCount(2, $rows['body']['rows']);
+
+ return [];
+ }
+
+ /**
+ * @depends testCreateRow
+ */
+ public function testRowsListQueries(array $data): array
+ {
+ $databaseId = $data['databaseId'];
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::search('title', 'Captain America')->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(1944, $rows['body']['rows'][0]['releaseYear']);
+ $this->assertCount(1, $rows['body']['rows']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::equal('$id', [$rows['body']['rows'][0]['$id']])->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(1944, $rows['body']['rows'][0]['releaseYear']);
+ $this->assertCount(1, $rows['body']['rows']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::search('title', 'Homecoming')->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(2017, $rows['body']['rows'][0]['releaseYear']);
+ $this->assertCount(1, $rows['body']['rows']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::search('title', 'spider')->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(2019, $rows['body']['rows'][0]['releaseYear']);
+ $this->assertEquals(2017, $rows['body']['rows'][1]['releaseYear']);
+ $this->assertCount(2, $rows['body']['rows']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ '{"method":"contains","attribute":"title","values":[bad]}'
+ ],
+ ]);
+
+ $this->assertEquals(400, $rows['headers']['status-code']);
+ $this->assertEquals('Invalid query: Syntax error', $rows['body']['message']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::contains('title', ['spi'])->toString(), // like query
+ ],
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(2, $rows['body']['total']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::equal('releaseYear', [1944])->toString(),
+ ],
+ ]);
+
+ $this->assertCount(1, $rows['body']['rows']);
+ $this->assertEquals('Captain America', $rows['body']['rows'][0]['title']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::notEqual('releaseYear', 1944)->toString(),
+ ],
+ ]);
+
+ $this->assertCount(2, $rows['body']['rows']);
+ $this->assertEquals('Spider-Man: Far From Home', $rows['body']['rows'][0]['title']);
+ $this->assertEquals('Spider-Man: Homecoming', $rows['body']['rows'][1]['title']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::greaterThan('$createdAt', '1976-06-12')->toString(),
+ ],
+ ]);
+
+ $this->assertCount(3, $rows['body']['rows']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::lessThan('$createdAt', '1976-06-12')->toString(),
+ ],
+ ]);
+
+ $this->assertCount(0, $rows['body']['rows']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::contains('actors', ['Tom Holland', 'Samuel Jackson'])->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(3, $rows['body']['total']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::contains('actors', ['Tom'])->toString(), // Full-match not like
+ ],
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(0, $rows['body']['total']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::greaterThan('birthDay', '16/01/2024 12:00:00AM')->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(400, $rows['headers']['status-code']);
+ $this->assertEquals('Invalid query: Query value is invalid for attribute "birthDay"', $rows['body']['message']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::greaterThan('birthDay', '1960-01-01 10:10:10+02:30')->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals('1975-06-12T12:12:55.000+00:00', $rows['body']['rows'][0]['birthDay']);
+ $this->assertEquals('1975-06-12T18:12:55.000+00:00', $rows['body']['rows'][1]['birthDay']);
+ $this->assertCount(2, $rows['body']['rows']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::isNull('integers')->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(1, $rows['body']['total']);
+
+ /**
+ * Test for Failure
+ */
+ $conditions = [];
+
+ for ($i = 0; $i < APP_DATABASE_QUERY_MAX_VALUES + 1; $i++) {
+ $conditions[] = $i;
+ }
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::equal('releaseYear', $conditions)->toString(),
+ ],
+ ]);
+ $this->assertEquals(400, $rows['headers']['status-code']);
+ $this->assertEquals('Invalid query: Query on attribute has greater than '.APP_DATABASE_QUERY_MAX_VALUES.' values: releaseYear', $rows['body']['message']);
+
+ $value = '';
+
+ for ($i = 0; $i < 101; $i++) {
+ $value .= "[" . $i . "] Too long title to cross 2k chars query limit ";
+ }
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::search('title', $value)->toString(),
+ ],
+ ]);
+
+ // Todo: Not sure what to do we with Query length Test VS old? JSON validator will fails if query string will be truncated?
+ //$this->assertEquals(400, $rows['headers']['status-code']);
+
+ // Todo: Disabled for CL - Uncomment after ProxyDatabase cleanup for find method
+ // $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ // 'content-type' => 'application/json',
+ // 'x-appwrite-project' => $this->getProject()['$id'],
+ // ], $this->getHeaders()), [
+ // 'queries' => [
+ // Query::search('actors', 'Tom')->toString(),
+ // ],
+ // ]);
+ // $this->assertEquals(400, $rows['headers']['status-code']);
+ // $this->assertEquals('Invalid query: Cannot query search on attribute "actors" because it is an array.', $rows['body']['message']);
+
+ return [];
+ }
+
+ /**
+ * @depends testCreateRow
+ */
+ public function testUpdateRow(array $data): array
+ {
+ $databaseId = $data['databaseId'];
+ $row = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Thor: Ragnaroc',
+ 'releaseYear' => 2017,
+ 'birthDay' => '1976-06-12 14:12:55',
+ 'actors' => [],
+ '$createdAt' => 5 // Should be ignored
+ ],
+ 'permissions' => [
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::delete(Role::user($this->getUser()['$id'])),
+ ],
+ ]);
+
+ $id = $row['body']['$id'];
+
+ $this->assertEquals(201, $row['headers']['status-code']);
+ $this->assertEquals($data['moviesId'], $row['body']['$tableId']);
+ $this->assertArrayNotHasKey('$table', $row['body']);
+ $this->assertEquals($databaseId, $row['body']['$databaseId']);
+ $this->assertEquals($row['body']['title'], 'Thor: Ragnaroc');
+ $this->assertEquals($row['body']['releaseYear'], 2017);
+ $dateValidator = new DatetimeValidator();
+ $this->assertEquals(true, $dateValidator->isValid($row['body']['$createdAt']));
+ $this->assertEquals(true, $dateValidator->isValid($row['body']['birthDay']));
+ $this->assertContains(Permission::read(Role::user($this->getUser()['$id'])), $row['body']['$permissions']);
+ $this->assertContains(Permission::update(Role::user($this->getUser()['$id'])), $row['body']['$permissions']);
+ $this->assertContains(Permission::delete(Role::user($this->getUser()['$id'])), $row['body']['$permissions']);
+
+ $row = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows/' . $id, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'title' => 'Thor: Ragnarok',
+ ],
+ 'permissions' => [
+ Permission::read(Role::users()),
+ Permission::update(Role::users()),
+ Permission::delete(Role::users()),
+ ],
+ ]);
+
+ $this->assertEquals(200, $row['headers']['status-code']);
+ $this->assertEquals($row['body']['$id'], $id);
+ $this->assertEquals($data['moviesId'], $row['body']['$tableId']);
+ $this->assertArrayNotHasKey('$table', $row['body']);
+ $this->assertEquals($databaseId, $row['body']['$databaseId']);
+ $this->assertEquals($row['body']['title'], 'Thor: Ragnarok');
+ $this->assertEquals($row['body']['releaseYear'], 2017);
+ $this->assertContains(Permission::read(Role::users()), $row['body']['$permissions']);
+ $this->assertContains(Permission::update(Role::users()), $row['body']['$permissions']);
+ $this->assertContains(Permission::delete(Role::users()), $row['body']['$permissions']);
+
+ $row = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows/' . $id, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $id = $row['body']['$id'];
+
+ $this->assertEquals(200, $row['headers']['status-code']);
+ $this->assertEquals($data['moviesId'], $row['body']['$tableId']);
+ $this->assertArrayNotHasKey('$table', $row['body']);
+ $this->assertEquals($databaseId, $row['body']['$databaseId']);
+ $this->assertEquals($row['body']['title'], 'Thor: Ragnarok');
+ $this->assertEquals($row['body']['releaseYear'], 2017);
+
+ $response = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows/' . $id, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-timestamp' => DateTime::formatTz(DateTime::now()),
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'title' => 'Thor: Ragnarok',
+ ],
+ ]);
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+
+ /**
+ * Test for failure
+ */
+
+ $response = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows/' . $id, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-timestamp' => 'invalid',
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'title' => 'Thor: Ragnarok',
+ ],
+ ]);
+
+ $this->assertEquals(400, $response['headers']['status-code']);
+ $this->assertEquals('Invalid X-Appwrite-Timestamp header value', $response['body']['message']);
+ $this->assertEquals(Exception::GENERAL_ARGUMENT_INVALID, $response['body']['type']);
+
+ $response = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows/' . $id, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-timestamp' => DateTime::formatTz(DateTime::addSeconds(new \DateTime(), -1000)),
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'title' => 'Thor: Ragnarok',
+ ],
+ ]);
+
+ $this->assertEquals(409, $response['headers']['status-code']);
+ $this->assertEquals('Remote row is newer than local.', $response['body']['message']);
+ $this->assertEquals(Exception::ROW_UPDATE_CONFLICT, $response['body']['type']);
+
+ return [];
+ }
+
+ /**
+ * @depends testCreateRow
+ */
+ public function testDeleteRow(array $data): array
+ {
+ $databaseId = $data['databaseId'];
+ $row = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Thor: Ragnarok',
+ 'releaseYear' => 2017,
+ 'birthDay' => '1975-06-12 14:12:55',
+ 'actors' => [],
+ ],
+ 'permissions' => [
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::delete(Role::user($this->getUser()['$id'])),
+ ]
+ ]);
+
+ $id = $row['body']['$id'];
+
+ $this->assertEquals(201, $row['headers']['status-code']);
+
+ $row = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows/' . $id, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $row['headers']['status-code']);
+
+ $row = $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows/' . $id, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(204, $row['headers']['status-code']);
+
+ $row = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows/' . $id, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(404, $row['headers']['status-code']);
+
+ return $data;
+ }
+
+ public function testInvalidRowStructure(): void
+ {
+ $database = $this->client->call(Client::METHOD_POST, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'databaseId' => ID::unique(),
+ 'name' => 'InvalidDocumentDatabase',
+ ]);
+ $this->assertEquals(201, $database['headers']['status-code']);
+ $this->assertEquals('InvalidDocumentDatabase', $database['body']['name']);
+
+ $databaseId = $database['body']['$id'];
+ $table = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'invalidDocumentStructure',
+ 'permissions' => [
+ Permission::create(Role::any()),
+ Permission::read(Role::any()),
+ ],
+ 'rowSecurity' => true,
+ ]);
+
+ $this->assertEquals(201, $table['headers']['status-code']);
+ $this->assertEquals('invalidDocumentStructure', $table['body']['name']);
+
+ $tableId = $table['body']['$id'];
+
+ $email = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/email', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'email',
+ 'required' => false,
+ ]);
+
+ $enum = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/enum', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'enum',
+ 'elements' => ['yes', 'no', 'maybe'],
+ 'required' => false,
+ ]);
+
+ $ip = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/ip', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'ip',
+ 'required' => false,
+ ]);
+
+ $url = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/url', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'url',
+ 'size' => 256,
+ 'required' => false,
+ ]);
+
+ $range = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/integer', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'range',
+ 'required' => false,
+ 'min' => 1,
+ 'max' => 10,
+ ]);
+
+ // TODO@kodumbeats min and max are rounded in error message
+ $floatRange = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/float', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'floatRange',
+ 'required' => false,
+ 'min' => 1.1,
+ 'max' => 1.4,
+ ]);
+
+ $probability = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/float', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'probability',
+ 'required' => false,
+ 'default' => 0,
+ 'min' => 0,
+ 'max' => 1,
+ ]);
+
+ $upperBound = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/integer', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'upperBound',
+ 'required' => false,
+ 'max' => 10,
+ ]);
+
+ $lowerBound = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/integer', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'lowerBound',
+ 'required' => false,
+ 'min' => 5,
+ ]);
+
+ /**
+ * Test for failure
+ */
+
+ $invalidRange = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/integer', array_merge([
+ 'content-type' => 'application/json', 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'invalidRange',
+ 'required' => false,
+ 'min' => 4,
+ 'max' => 3,
+ ]);
+
+ $defaultArray = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/integer', array_merge([
+ 'content-type' => 'application/json', 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'defaultArray',
+ 'required' => false,
+ 'default' => 42,
+ 'array' => true,
+ ]);
+
+ $defaultRequired = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/integer', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'attributeId' => ID::custom('defaultRequired'),
+ 'required' => true,
+ 'default' => 12
+ ]);
+
+ $enumDefault = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/enum', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'attributeId' => ID::custom('enumDefault'),
+ 'elements' => ['north', 'west'],
+ 'default' => 'south'
+ ]);
+
+ $enumDefaultStrict = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/enum', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'attributeId' => ID::custom('enumDefault'),
+ 'elements' => ['north', 'west'],
+ 'default' => 'NORTH'
+ ]);
+
+ $goodDatetime = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/datetime', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'birthDay',
+ 'required' => false,
+ 'default' => null
+ ]);
+
+ $datetimeDefault = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/datetime', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'badBirthDay',
+ 'required' => false,
+ 'default' => 'bad'
+ ]);
+
+ $this->assertEquals(202, $email['headers']['status-code']);
+ $this->assertEquals(202, $ip['headers']['status-code']);
+ $this->assertEquals(202, $url['headers']['status-code']);
+ $this->assertEquals(202, $range['headers']['status-code']);
+ $this->assertEquals(202, $floatRange['headers']['status-code']);
+ $this->assertEquals(202, $probability['headers']['status-code']);
+ $this->assertEquals(202, $upperBound['headers']['status-code']);
+ $this->assertEquals(202, $lowerBound['headers']['status-code']);
+ $this->assertEquals(202, $enum['headers']['status-code']);
+ $this->assertEquals(202, $goodDatetime['headers']['status-code']);
+ $this->assertEquals(400, $invalidRange['headers']['status-code']);
+ $this->assertEquals(400, $defaultArray['headers']['status-code']);
+ $this->assertEquals(400, $defaultRequired['headers']['status-code']);
+ $this->assertEquals(400, $enumDefault['headers']['status-code']);
+ $this->assertEquals(400, $enumDefaultStrict['headers']['status-code']);
+ $this->assertEquals('Minimum value must be lesser than maximum value', $invalidRange['body']['message']);
+ $this->assertEquals('Cannot set default value for array columns', $defaultArray['body']['message']);
+ $this->assertEquals(400, $datetimeDefault['headers']['status-code']);
+
+ // wait for worker to add attributes
+ sleep(3);
+
+ $table = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ]));
+
+ $this->assertCount(10, $table['body']['columns']);
+
+ /**
+ * Test for successful validation
+ */
+
+ $goodEmail = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'email' => 'user@example.com',
+ ],
+ 'permissions' => [
+ Permission::read(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::update(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::delete(Role::user(ID::custom($this->getUser()['$id']))),
+ ]
+ ]);
+
+ $goodEnum = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'enum' => 'yes',
+ ],
+ 'permissions' => [
+ Permission::read(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::update(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::delete(Role::user(ID::custom($this->getUser()['$id']))),
+ ]
+ ]);
+
+ $goodIp = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'ip' => '1.1.1.1',
+ ],
+ 'permissions' => [
+ Permission::read(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::update(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::delete(Role::user(ID::custom($this->getUser()['$id']))),
+ ]
+ ]);
+
+ $goodUrl = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'url' => 'http://www.example.com',
+ ],
+ 'permissions' => [
+ Permission::read(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::update(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::delete(Role::user(ID::custom($this->getUser()['$id']))),
+ ]
+ ]);
+
+ $goodRange = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'range' => 3,
+ ],
+ 'permissions' => [
+ Permission::read(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::update(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::delete(Role::user(ID::custom($this->getUser()['$id']))),
+ ]
+ ]);
+
+ $goodFloatRange = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'floatRange' => 1.4,
+ ],
+ 'permissions' => [
+ Permission::read(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::update(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::delete(Role::user(ID::custom($this->getUser()['$id']))),
+ ]
+ ]);
+
+ $goodProbability = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'probability' => 0.99999,
+ ],
+ 'permissions' => [
+ Permission::read(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::update(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::delete(Role::user(ID::custom($this->getUser()['$id']))),
+ ]
+ ]);
+
+ $notTooHigh = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'upperBound' => 8,
+ ],
+ 'permissions' => [
+ Permission::read(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::update(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::delete(Role::user(ID::custom($this->getUser()['$id']))),
+ ]
+ ]);
+
+ $notTooLow = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'lowerBound' => 8,
+ ],
+ 'permissions' => [
+ Permission::read(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::update(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::delete(Role::user(ID::custom($this->getUser()['$id']))),
+ ]
+ ]);
+
+ $this->assertEquals(201, $goodEmail['headers']['status-code']);
+ $this->assertEquals(201, $goodEnum['headers']['status-code']);
+ $this->assertEquals(201, $goodIp['headers']['status-code']);
+ $this->assertEquals(201, $goodUrl['headers']['status-code']);
+ $this->assertEquals(201, $goodRange['headers']['status-code']);
+ $this->assertEquals(201, $goodFloatRange['headers']['status-code']);
+ $this->assertEquals(201, $goodProbability['headers']['status-code']);
+ $this->assertEquals(201, $notTooHigh['headers']['status-code']);
+ $this->assertEquals(201, $notTooLow['headers']['status-code']);
+
+ /*
+ * Test that custom validators reject documents
+ */
+
+ $badEmail = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'email' => 'user@@example.com',
+ ],
+ 'permissions' => [
+ Permission::read(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::update(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::delete(Role::user(ID::custom($this->getUser()['$id']))),
+ ]
+ ]);
+
+ $badEnum = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'enum' => 'badEnum',
+ ],
+ 'permissions' => [
+ Permission::read(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::update(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::delete(Role::user(ID::custom($this->getUser()['$id']))),
+ ]
+ ]);
+
+ $badIp = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'ip' => '1.1.1.1.1',
+ ],
+ 'permissions' => [
+ Permission::read(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::update(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::delete(Role::user(ID::custom($this->getUser()['$id']))),
+ ]
+ ]);
+
+ $badUrl = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'url' => 'example...com',
+ ],
+ 'permissions' => [
+ Permission::read(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::update(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::delete(Role::user(ID::custom($this->getUser()['$id']))),
+ ]
+ ]);
+
+ $badRange = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'range' => 11,
+ ],
+ 'permissions' => [
+ Permission::read(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::update(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::delete(Role::user(ID::custom($this->getUser()['$id']))),
+ ]
+ ]);
+
+ $badFloatRange = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'floatRange' => 2.5,
+ ],
+ 'permissions' => [
+ Permission::read(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::update(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::delete(Role::user(ID::custom($this->getUser()['$id']))),
+ ]
+ ]);
+
+ $badProbability = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'probability' => 1.1,
+ ],
+ 'permissions' => [
+ Permission::read(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::update(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::delete(Role::user(ID::custom($this->getUser()['$id']))),
+ ]
+ ]);
+
+ $tooHigh = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'upperBound' => 11,
+ ],
+ 'permissions' => [
+ Permission::read(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::update(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::delete(Role::user(ID::custom($this->getUser()['$id']))),
+ ]
+ ]);
+
+ $tooLow = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'lowerBound' => 3,
+ ],
+ 'permissions' => [
+ Permission::read(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::update(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::delete(Role::user(ID::custom($this->getUser()['$id']))),
+ ]
+ ]);
+
+ $badTime = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => 'unique()',
+ 'data' => [
+ 'birthDay' => '2020-10-10 27:30:10+01:00',
+ ],
+ 'read' => ['user:' . $this->getUser()['$id']],
+ 'write' => ['user:' . $this->getUser()['$id']],
+ ]);
+
+ $this->assertEquals(400, $badEmail['headers']['status-code']);
+ $this->assertEquals(400, $badEnum['headers']['status-code']);
+ $this->assertEquals(400, $badIp['headers']['status-code']);
+ $this->assertEquals(400, $badUrl['headers']['status-code']);
+ $this->assertEquals(400, $badRange['headers']['status-code']);
+ $this->assertEquals(400, $badFloatRange['headers']['status-code']);
+ $this->assertEquals(400, $badProbability['headers']['status-code']);
+ $this->assertEquals(400, $tooHigh['headers']['status-code']);
+ $this->assertEquals(400, $tooLow['headers']['status-code']);
+ $this->assertEquals(400, $badTime['headers']['status-code']);
+
+ // TODO: @itznotabug - database library needs to throw error based on context!
+ $this->assertEquals('Invalid document structure: Attribute "email" has invalid format. Value must be a valid email address', $badEmail['body']['message']);
+ $this->assertEquals('Invalid document structure: Attribute "enum" has invalid format. Value must be one of (yes, no, maybe)', $badEnum['body']['message']);
+ $this->assertEquals('Invalid document structure: Attribute "ip" has invalid format. Value must be a valid IP address', $badIp['body']['message']);
+ $this->assertEquals('Invalid document structure: Attribute "url" has invalid format. Value must be a valid URL', $badUrl['body']['message']);
+ $this->assertEquals('Invalid document structure: Attribute "range" has invalid format. Value must be a valid range between 1 and 10', $badRange['body']['message']);
+ $this->assertEquals('Invalid document structure: Attribute "floatRange" has invalid format. Value must be a valid range between 1 and 1', $badFloatRange['body']['message']);
+ $this->assertEquals('Invalid document structure: Attribute "probability" has invalid format. Value must be a valid range between 0 and 1', $badProbability['body']['message']);
+ $this->assertEquals('Invalid document structure: Attribute "upperBound" has invalid format. Value must be a valid range between -9,223,372,036,854,775,808 and 10', $tooHigh['body']['message']);
+ $this->assertEquals('Invalid document structure: Attribute "lowerBound" has invalid format. Value must be a valid range between 5 and 9,223,372,036,854,775,807', $tooLow['body']['message']);
+ }
+
+ /**
+ * @depends testDeleteRow
+ */
+ public function testDefaultPermissions(array $data): array
+ {
+ $databaseId = $data['databaseId'];
+ $row = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Captain America',
+ 'releaseYear' => 1944,
+ 'actors' => [],
+ ],
+ ]);
+
+ $id = $row['body']['$id'];
+
+ $this->assertEquals(201, $row['headers']['status-code']);
+ $this->assertEquals($row['body']['title'], 'Captain America');
+ $this->assertEquals($row['body']['releaseYear'], 1944);
+ $this->assertIsArray($row['body']['$permissions']);
+
+ if ($this->getSide() == 'client') {
+ $this->assertCount(3, $row['body']['$permissions']);
+ $this->assertContains(Permission::read(Role::user($this->getUser()['$id'])), $row['body']['$permissions']);
+ $this->assertContains(Permission::update(Role::user($this->getUser()['$id'])), $row['body']['$permissions']);
+ $this->assertContains(Permission::delete(Role::user($this->getUser()['$id'])), $row['body']['$permissions']);
+ }
+
+ if ($this->getSide() == 'server') {
+ $this->assertCount(0, $row['body']['$permissions']);
+ $this->assertEquals([], $row['body']['$permissions']);
+ }
+
+ // Updated Permissions
+
+ $row = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows/' . $id, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'title' => 'Captain America 2',
+ 'releaseYear' => 1945,
+ 'actors' => [],
+ ],
+ 'permissions' => [
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id']))
+ ],
+ ]);
+
+ $this->assertEquals(200, $row['headers']['status-code']);
+ $this->assertEquals($row['body']['title'], 'Captain America 2');
+ $this->assertEquals($row['body']['releaseYear'], 1945);
+
+ // This differs from the old permissions model because we don't inherit
+ // existing row permissions on update, unless none were supplied,
+ // so that specific types can be removed if wanted.
+ $this->assertCount(2, $row['body']['$permissions']);
+ $this->assertEquals([
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ ], $row['body']['$permissions']);
+
+ $row = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows/' . $id, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $row['headers']['status-code']);
+ $this->assertEquals($row['body']['title'], 'Captain America 2');
+ $this->assertEquals($row['body']['releaseYear'], 1945);
+
+ $this->assertCount(2, $row['body']['$permissions']);
+ $this->assertEquals([
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ ], $row['body']['$permissions']);
+
+ // Reset Permissions
+
+ $row = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows/' . $id, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'title' => 'Captain America 3',
+ 'releaseYear' => 1946,
+ 'actors' => [],
+ ],
+ 'permissions' => [],
+ ]);
+
+ $this->assertEquals(200, $row['headers']['status-code']);
+ $this->assertEquals($row['body']['title'], 'Captain America 3');
+ $this->assertEquals($row['body']['releaseYear'], 1946);
+ $this->assertCount(0, $row['body']['$permissions']);
+ $this->assertEquals([], $row['body']['$permissions']);
+
+ // Check client side can no longer read the row.
+ $row = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows/' . $id, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ switch ($this->getSide()) {
+ case 'client':
+ $this->assertEquals(404, $row['headers']['status-code']);
+ break;
+ case 'server':
+ $this->assertEquals(200, $row['headers']['status-code']);
+ break;
+ }
+
+ return $data;
+ }
+
+ public function testEnforceTableAndRowPermissions(): void
+ {
+ $database = $this->client->call(Client::METHOD_POST, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'databaseId' => ID::unique(),
+ 'name' => 'EnforceCollectionAndDocumentPermissions',
+ ]);
+ $this->assertEquals(201, $database['headers']['status-code']);
+ $this->assertEquals('EnforceCollectionAndDocumentPermissions', $database['body']['name']);
+
+ $databaseId = $database['body']['$id'];
+ $user = $this->getUser()['$id'];
+ $table = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'enforceCollectionAndDocumentPermissions',
+ 'rowSecurity' => true,
+ 'permissions' => [
+ Permission::read(Role::user($user)),
+ Permission::create(Role::user($user)),
+ Permission::update(Role::user($user)),
+ Permission::delete(Role::user($user)),
+ ],
+ ]);
+
+ $this->assertEquals(201, $table['headers']['status-code']);
+ $this->assertEquals($table['body']['name'], 'enforceCollectionAndDocumentPermissions');
+ $this->assertEquals($table['body']['rowSecurity'], true);
+
+ $tableId = $table['body']['$id'];
+
+ sleep(2);
+
+ $attribute = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'attribute',
+ 'size' => 64,
+ 'required' => true,
+ ]);
+
+ $this->assertEquals(202, $attribute['headers']['status-code'], 202);
+ $this->assertEquals('attribute', $attribute['body']['key']);
+
+ // wait for db to add attribute
+ sleep(2);
+
+ $index = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'key_attribute',
+ 'type' => 'key',
+ 'columns' => [$attribute['body']['key']],
+ ]);
+
+ $this->assertEquals(202, $index['headers']['status-code']);
+ $this->assertEquals('key_attribute', $index['body']['key']);
+
+ // wait for db to add attribute
+ sleep(2);
+
+ $row1 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'attribute' => 'one',
+ ],
+ 'permissions' => [
+ Permission::read(Role::user($user)),
+ Permission::update(Role::user($user)),
+ Permission::delete(Role::user($user)),
+ ]
+ ]);
+
+ $this->assertEquals(201, $row1['headers']['status-code']);
+
+ $row2 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'attribute' => 'one',
+ ],
+ 'permissions' => [
+ Permission::update(Role::user($user)),
+ Permission::delete(Role::user($user)),
+ ]
+ ]);
+
+ $this->assertEquals(201, $row2['headers']['status-code']);
+
+ $row3 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'attribute' => 'one',
+ ],
+ 'permissions' => [
+ Permission::read(Role::user(ID::custom('other'))),
+ Permission::update(Role::user(ID::custom('other'))),
+ ],
+ ]);
+
+ $this->assertEquals(201, $row3['headers']['status-code']);
+
+ $rowsUser1 = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ // Current user has read permission on the table so can get any row
+ $this->assertEquals(3, $rowsUser1['body']['total']);
+ $this->assertCount(3, $rowsUser1['body']['rows']);
+
+ $row3GetWithCollectionRead = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows/' . $row3['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ // Current user has read permission on the table so can get any row
+ $this->assertEquals(200, $row3GetWithCollectionRead['headers']['status-code']);
+
+ $email = uniqid() . 'user@localhost.test';
+ $password = 'password';
+ $name = 'User Name';
+ $this->client->call(Client::METHOD_POST, '/account', [
+ 'origin' => 'http://localhost',
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], [
+ 'userId' => ID::custom('other'),
+ 'email' => $email,
+ 'password' => $password,
+ 'name' => $name,
+ ]);
+ $session2 = $this->client->call(Client::METHOD_POST, '/account/sessions/email', [
+ 'origin' => 'http://localhost',
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], [
+ 'email' => $email,
+ 'password' => $password,
+ ]);
+ $session2 = $session2['cookies']['a_session_' . $this->getProject()['$id']];
+
+ $row3GetWithDocumentRead = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows/' . $row3['body']['$id'], [
+ 'origin' => 'http://localhost',
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'cookie' => 'a_session_' . $this->getProject()['$id'] . '=' . $session2,
+ ]);
+
+ // Current user has no table permissions but has read permission for this row
+ $this->assertEquals(200, $row3GetWithDocumentRead['headers']['status-code']);
+
+ $row2GetFailure = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows/' . $row2['body']['$id'], [
+ 'origin' => 'http://localhost',
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'cookie' => 'a_session_' . $this->getProject()['$id'] . '=' . $session2,
+ ]);
+
+ // Current user has no table or row permissions for this row
+ $this->assertEquals(404, $row2GetFailure['headers']['status-code']);
+
+ $rowsUser2 = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', [
+ 'origin' => 'http://localhost',
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'cookie' => 'a_session_' . $this->getProject()['$id'] . '=' . $session2,
+ ]);
+
+ // Current user has no table permissions but has read permission for one row
+ $this->assertEquals(1, $rowsUser2['body']['total']);
+ $this->assertCount(1, $rowsUser2['body']['rows']);
+ }
+
+ public function testEnforceTablePermissions(): void
+ {
+ $database = $this->client->call(Client::METHOD_POST, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'databaseId' => ID::unique(),
+ 'name' => 'EnforceCollectionPermissions',
+ ]);
+ $this->assertEquals(201, $database['headers']['status-code']);
+ $this->assertEquals('EnforceCollectionPermissions', $database['body']['name']);
+
+ $databaseId = $database['body']['$id'];
+ $user = $this->getUser()['$id'];
+ $table = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'enforceCollectionPermissions',
+ 'permissions' => [
+ Permission::read(Role::user($user)),
+ Permission::create(Role::user($user)),
+ Permission::update(Role::user($user)),
+ Permission::delete(Role::user($user)),
+ ],
+ ]);
+
+ $this->assertEquals(201, $table['headers']['status-code']);
+ $this->assertEquals($table['body']['name'], 'enforceCollectionPermissions');
+ $this->assertEquals($table['body']['rowSecurity'], false);
+
+ $tableId = $table['body']['$id'];
+
+ $attribute = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'attribute',
+ 'size' => 64,
+ 'required' => true,
+ ]);
+
+ $this->assertEquals(202, $attribute['headers']['status-code'], 202);
+ $this->assertEquals('attribute', $attribute['body']['key']);
+
+ \sleep(2);
+
+ $index = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'key_attribute',
+ 'type' => 'key',
+ 'columns' => [$attribute['body']['key']],
+ ]);
+
+ $this->assertEquals(202, $index['headers']['status-code']);
+ $this->assertEquals('key_attribute', $index['body']['key']);
+
+ \sleep(2);
+
+ $row1 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'attribute' => 'one',
+ ],
+ 'permissions' => [
+ Permission::read(Role::user($user)),
+ Permission::update(Role::user($user)),
+ Permission::delete(Role::user($user)),
+ ]
+ ]);
+
+ $this->assertEquals(201, $row1['headers']['status-code']);
+
+ $row2 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'attribute' => 'one',
+ ],
+ 'permissions' => [
+ Permission::update(Role::user($user)),
+ Permission::delete(Role::user($user)),
+ ]
+ ]);
+
+ $this->assertEquals(201, $row2['headers']['status-code']);
+
+ $row3 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'attribute' => 'one',
+ ],
+ 'permissions' => [
+ Permission::read(Role::user(ID::custom('other2'))),
+ Permission::update(Role::user(ID::custom('other2'))),
+ ],
+ ]);
+
+ $this->assertEquals(201, $row3['headers']['status-code']);
+
+ $rowsUser1 = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ // Current user has read permission on the table so can get any row
+ $this->assertEquals(3, $rowsUser1['body']['total']);
+ $this->assertCount(3, $rowsUser1['body']['rows']);
+
+ $row3GetWithCollectionRead = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows/' . $row3['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ // Current user has read permission on the table so can get any row
+ $this->assertEquals(200, $row3GetWithCollectionRead['headers']['status-code']);
+
+ $email = uniqid() . 'user2@localhost.test';
+ $password = 'password';
+ $name = 'User Name';
+ $this->client->call(Client::METHOD_POST, '/account', [
+ 'origin' => 'http://localhost',
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], [
+ 'userId' => ID::custom('other2'),
+ 'email' => $email,
+ 'password' => $password,
+ 'name' => $name,
+ ]);
+ $session2 = $this->client->call(Client::METHOD_POST, '/account/sessions/email', [
+ 'origin' => 'http://localhost',
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], [
+ 'email' => $email,
+ 'password' => $password,
+ ]);
+ $session2 = $session2['cookies']['a_session_' . $this->getProject()['$id']];
+
+ $row3GetWithDocumentRead = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows/' . $row3['body']['$id'], [
+ 'origin' => 'http://localhost',
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'cookie' => 'a_session_' . $this->getProject()['$id'] . '=' . $session2,
+ ]);
+
+ // other2 has no table permissions and row permissions are disabled
+ $this->assertEquals(404, $row3GetWithDocumentRead['headers']['status-code']);
+
+ $rowsUser2 = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', [
+ 'origin' => 'http://localhost',
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'cookie' => 'a_session_' . $this->getProject()['$id'] . '=' . $session2,
+ ]);
+
+ // other2 has no table permissions and row permissions are disabled
+ $this->assertEquals(401, $rowsUser2['headers']['status-code']);
+
+ // Enable row permissions
+ $this->client->call(CLient::METHOD_PUT, '/databases/' . $databaseId . '/tables/' . $tableId, [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], [
+ 'name' => $table['body']['name'],
+ 'rowSecurity' => true,
+ ]);
+
+ $rowsUser2 = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', [
+ 'origin' => 'http://localhost',
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'cookie' => 'a_session_' . $this->getProject()['$id'] . '=' . $session2,
+ ]);
+
+ // Current user has no table permissions read access to one row
+ $this->assertEquals(1, $rowsUser2['body']['total']);
+ $this->assertCount(1, $rowsUser2['body']['rows']);
+ }
+
+ /**
+ * @depends testDefaultPermissions
+ */
+ public function testUniqueIndexDuplicate(array $data): array
+ {
+ $databaseId = $data['databaseId'];
+ $uniqueIndex = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'unique_title',
+ 'type' => 'unique',
+ 'columns' => ['title'],
+ ]);
+
+ $this->assertEquals(202, $uniqueIndex['headers']['status-code']);
+
+ sleep(2);
+
+ // test for failure
+ $duplicate = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Captain America',
+ 'releaseYear' => 1944,
+ 'actors' => [
+ 'Chris Evans',
+ 'Samuel Jackson',
+ ]
+ ],
+ 'permissions' => [
+ Permission::read(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::update(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::delete(Role::user(ID::custom($this->getUser()['$id']))),
+ ]
+ ]);
+
+ $this->assertEquals(409, $duplicate['headers']['status-code']);
+
+ // Test for exception when updating row to conflict
+ $row = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Captain America 5',
+ 'releaseYear' => 1944,
+ 'actors' => [
+ 'Chris Evans',
+ 'Samuel Jackson',
+ ]
+ ],
+ 'permissions' => [
+ Permission::read(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::update(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::delete(Role::user(ID::custom($this->getUser()['$id']))),
+ ]
+ ]);
+
+ $this->assertEquals(201, $row['headers']['status-code']);
+
+ // Test for exception when updating row to conflict
+ $duplicate = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/rows/' . $row['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Captain America',
+ 'releaseYear' => 1944,
+ 'actors' => [
+ 'Chris Evans',
+ 'Samuel Jackson',
+ ]
+ ],
+ 'permissions' => [
+ Permission::read(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::update(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::delete(Role::user(ID::custom($this->getUser()['$id']))),
+ ]
+ ]);
+
+ $this->assertEquals(409, $duplicate['headers']['status-code']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testUniqueIndexDuplicate
+ */
+ public function testPersistentCreatedAt(array $data): array
+ {
+ $headers = $this->getSide() === 'client' ? array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()) : [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ];
+
+ $row = $this->client->call(Client::METHOD_POST, '/databases/' . $data['databaseId'] . '/tables/' . $data['moviesId'] . '/rows', $headers, [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Creation Date Test',
+ 'releaseYear' => 2000
+ ]
+ ]);
+
+ $this->assertEquals($row['body']['title'], 'Creation Date Test');
+
+ $rowId = $row['body']['$id'];
+ $createdAt = $row['body']['$createdAt'];
+ $updatedAt = $row['body']['$updatedAt'];
+
+ \sleep(1);
+
+ $row = $this->client->call(Client::METHOD_PATCH, '/databases/' . $data['databaseId'] . '/tables/' . $data['moviesId'] . '/rows/' . $rowId, $headers, [
+ 'data' => [
+ 'title' => 'Updated Date Test',
+ ]
+ ]);
+
+ $updatedAtSecond = $row['body']['$updatedAt'];
+
+ $this->assertEquals($row['body']['title'], 'Updated Date Test');
+ $this->assertEquals($row['body']['$createdAt'], $createdAt);
+ $this->assertNotEquals($row['body']['$updatedAt'], $updatedAt);
+
+ \sleep(1);
+
+ $row = $this->client->call(Client::METHOD_PATCH, '/databases/' . $data['databaseId'] . '/tables/' . $data['moviesId'] . '/rows/' . $rowId, $headers, [
+ 'data' => [
+ 'title' => 'Again Updated Date Test',
+ '$createdAt' => '2022-08-01 13:09:23.040', // $createdAt is not updatable
+ '$updatedAt' => '2022-08-01 13:09:23.050' // system will update it not api
+ ]
+ ]);
+
+ $this->assertEquals($row['body']['title'], 'Again Updated Date Test');
+ $this->assertEquals($row['body']['$createdAt'], $createdAt);
+ $this->assertNotEquals($row['body']['$createdAt'], '2022-08-01 13:09:23.040');
+ $this->assertNotEquals($row['body']['$updatedAt'], $updatedAt);
+ $this->assertNotEquals($row['body']['$updatedAt'], $updatedAtSecond);
+ $this->assertNotEquals($row['body']['$updatedAt'], '2022-08-01 13:09:23.050');
+
+ return $data;
+ }
+
+ public function testUpdatePermissionsWithEmptyPayload(): array
+ {
+ // Create Database
+ $database = $this->client->call(Client::METHOD_POST, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'databaseId' => ID::unique(),
+ 'name' => 'Empty Permissions',
+ ]);
+ $this->assertEquals(201, $database['headers']['status-code']);
+
+ $databaseId = $database['body']['$id'];
+
+ // Create table
+ $movies = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Movies',
+ 'permissions' => [
+ Permission::create(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::read(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::update(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::delete(Role::user(ID::custom($this->getUser()['$id']))),
+ ],
+ 'rowSecurity' => true,
+ ]);
+
+ $this->assertEquals(201, $movies['headers']['status-code']);
+ $this->assertEquals($movies['body']['name'], 'Movies');
+
+ $moviesId = $movies['body']['$id'];
+
+ // create attribute
+ $title = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $moviesId . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'title',
+ 'size' => 256,
+ 'required' => true,
+ ]);
+
+ $this->assertEquals(202, $title['headers']['status-code']);
+
+ // wait for database worker to create attributes
+ sleep(2);
+
+ // add row
+ $row = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $moviesId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Captain America',
+ ],
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ ]);
+
+ $id = $row['body']['$id'];
+
+ $this->assertEquals(201, $row['headers']['status-code']);
+ $this->assertCount(3, $row['body']['$permissions']);
+ $this->assertContains(Permission::read(Role::any()), $row['body']['$permissions']);
+ $this->assertContains(Permission::update(Role::any()), $row['body']['$permissions']);
+ $this->assertContains(Permission::delete(Role::any()), $row['body']['$permissions']);
+
+ // Send only read permission
+ $row = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $moviesId . '/rows/' . $id, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'permissions' => [
+ Permission::read(Role::user(ID::custom($this->getUser()['$id']))),
+ ]
+ ]);
+
+ $this->assertEquals(200, $row['headers']['status-code']);
+ $this->assertCount(1, $row['body']['$permissions']);
+
+ // Send only mutation permissions
+ $row = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $moviesId . '/rows/' . $id, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'permissions' => [
+ Permission::update(Role::user(ID::custom($this->getUser()['$id']))),
+ Permission::delete(Role::user(ID::custom($this->getUser()['$id']))),
+ ],
+ ]);
+
+ if ($this->getSide() == 'server') {
+ $this->assertEquals(200, $row['headers']['status-code']);
+ $this->assertCount(2, $row['body']['$permissions']);
+ $this->assertContains(Permission::update(Role::user($this->getUser()['$id'])), $row['body']['$permissions']);
+ $this->assertContains(Permission::delete(Role::user($this->getUser()['$id'])), $row['body']['$permissions']);
+ }
+
+ // remove table
+ $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $moviesId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ return [];
+ }
+
+ /**
+ * @depends testCreateDatabase
+ */
+ public function testColumnBooleanDefault(array $data): void
+ {
+ $databaseId = $data['databaseId'];
+
+ /**
+ * Test for SUCCESS
+ */
+ $table = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Boolean'
+ ]);
+
+ $this->assertEquals(201, $table['headers']['status-code']);
+
+ $tableId = $table['body']['$id'];
+
+ $true = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/boolean', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'true',
+ 'required' => false,
+ 'default' => true
+ ]);
+
+ $this->assertEquals(202, $true['headers']['status-code']);
+
+ $false = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/boolean', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'false',
+ 'required' => false,
+ 'default' => false
+ ]);
+
+ $this->assertEquals(202, $false['headers']['status-code']);
+ }
+
+ /**
+ * @depends testCreateDatabase
+ */
+ public function testOneToOneRelationship(array $data): array
+ {
+ $databaseId = $data['databaseId'];
+
+ $person = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => 'person',
+ 'name' => 'person',
+ 'permissions' => [
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::delete(Role::user($this->getUser()['$id'])),
+ Permission::create(Role::user($this->getUser()['$id'])),
+ ],
+ 'rowSecurity' => true,
+ ]);
+
+ $this->assertEquals(201, $person['headers']['status-code']);
+
+ $library = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => 'library',
+ 'name' => 'library',
+ 'permissions' => [
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::create(Role::user($this->getUser()['$id'])),
+ ],
+ 'rowSecurity' => true,
+ ]);
+
+ $this->assertEquals(201, $library['headers']['status-code']);
+
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $person['body']['$id'] . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'fullName',
+ 'size' => 255,
+ 'required' => false,
+ ]);
+
+ sleep(1); // Wait for worker
+
+ $relation = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $person['body']['$id'] . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'relatedTableId' => 'library',
+ 'type' => Database::RELATION_ONE_TO_ONE,
+ 'key' => 'library',
+ 'twoWay' => true,
+ 'onDelete' => Database::RELATION_MUTATE_CASCADE,
+ ]);
+
+ sleep(1); // Wait for worker
+
+ $libraryName = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $library['body']['$id'] . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'libraryName',
+ 'size' => 255,
+ 'required' => true,
+ ]);
+
+ sleep(1); // Wait for worker
+
+ $this->assertEquals(202, $libraryName['headers']['status-code']);
+ $this->assertEquals(202, $relation['headers']['status-code']);
+ $this->assertEquals('library', $relation['body']['key']);
+ $this->assertEquals('relationship', $relation['body']['type']);
+ $this->assertEquals('processing', $relation['body']['status']);
+
+ $columns = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $person['body']['$id'] . '/columns', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals(200, $columns['headers']['status-code']);
+ $this->assertEquals(2, $columns['body']['total']);
+ $columns = $columns['body']['columns'];
+ $this->assertEquals('library', $columns[1]['relatedTable']);
+ $this->assertEquals('oneToOne', $columns[1]['relationType']);
+ $this->assertEquals(true, $columns[1]['twoWay']);
+ $this->assertEquals('person', $columns[1]['twoWayKey']);
+ $this->assertEquals(Database::RELATION_MUTATE_CASCADE, $columns[1]['onDelete']);
+
+ $attribute = $this->client->call(Client::METHOD_GET, "/databases/{$databaseId}/tables/{$person['body']['$id']}/columns/library", array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals(200, $attribute['headers']['status-code']);
+ $this->assertEquals('available', $attribute['body']['status']);
+ $this->assertEquals('library', $attribute['body']['key']);
+ $this->assertEquals('relationship', $attribute['body']['type']);
+ $this->assertEquals(false, $attribute['body']['required']);
+ $this->assertEquals(false, $attribute['body']['array']);
+ $this->assertEquals('oneToOne', $attribute['body']['relationType']);
+ $this->assertEquals(true, $attribute['body']['twoWay']);
+ $this->assertEquals('person', $attribute['body']['twoWayKey']);
+ $this->assertEquals(Database::RELATION_MUTATE_CASCADE, $attribute['body']['onDelete']);
+
+ $person1 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $person['body']['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'library' => [
+ '$id' => 'library1',
+ '$permissions' => [
+ Permission::read(Role::any()),
+ ],
+ 'libraryName' => 'Library 1',
+ ],
+ ],
+ 'permissions' => [
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::delete(Role::user($this->getUser()['$id'])),
+ ]
+ ]);
+
+ $this->assertEquals('Library 1', $person1['body']['library']['libraryName']);
+
+ // Create without nested ID
+ $person2 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $person['body']['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'library' => [
+ 'libraryName' => 'Library 2',
+ ],
+ ],
+ 'permissions' => [
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::delete(Role::user($this->getUser()['$id'])),
+ ]
+ ]);
+
+ $this->assertEquals('Library 2', $person2['body']['library']['libraryName']);
+
+ // Ensure IDs were set and internal IDs removed
+ $this->assertEquals($databaseId, $person1['body']['$databaseId']);
+ $this->assertEquals($databaseId, $person1['body']['library']['$databaseId']);
+
+ $this->assertEquals($person['body']['$id'], $person1['body']['$tableId']);
+ $this->assertEquals($library['body']['$id'], $person1['body']['library']['$tableId']);
+
+ $this->assertArrayNotHasKey('$table', $person1['body']);
+ $this->assertArrayNotHasKey('$table', $person1['body']['library']);
+ $this->assertArrayNotHasKey('$internalId', $person1['body']);
+ $this->assertArrayNotHasKey('$internalId', $person1['body']['library']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $person['body']['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::select(['fullName', 'library.*'])->toString(),
+ Query::equal('library', ['library1'])->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(1, $rows['body']['total']);
+ $this->assertEquals('Library 1', $rows['body']['rows'][0]['library']['libraryName']);
+ $this->assertArrayHasKey('fullName', $rows['body']['rows'][0]);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $person['body']['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::equal('library.libraryName', ['Library 1'])->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(400, $rows['headers']['status-code']);
+ $this->assertEquals('Invalid query: Cannot query nested attribute on: library', $rows['body']['message']);
+
+ $response = $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $person['body']['$id'] . '/columns/library', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ sleep(2);
+
+ $this->assertEquals(204, $response['headers']['status-code']);
+
+ $attribute = $this->client->call(Client::METHOD_GET, "/databases/{$databaseId}/tables/{$person['body']['$id']}/columns/library", array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals(404, $attribute['headers']['status-code']);
+
+ $person1 = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $person['body']['$id'] . '/rows/' . $person1['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertArrayNotHasKey('library', $person1['body']);
+
+ //Test Deletion of related twoKey
+ $columns = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $library['body']['$id'] . '/columns', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals(200, $columns['headers']['status-code']);
+ $this->assertEquals(1, $columns['body']['total']);
+ $this->assertEquals('libraryName', $columns['body']['columns'][0]['key']);
+
+ return [
+ 'databaseId' => $databaseId,
+ 'personCollection' => $person['body']['$id'],
+ 'libraryCollection' => $library['body']['$id'],
+ ];
+ }
+
+ /**
+ * @depends testOneToOneRelationship
+ */
+ public function testOneToManyRelationship(array $data): array
+ {
+ $databaseId = $data['databaseId'];
+ $personCollection = $data['personCollection'];
+ $libraryCollection = $data['libraryCollection'];
+
+ // One person can own several libraries
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $personCollection . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'relatedTableId' => 'library',
+ 'type' => Database::RELATION_ONE_TO_MANY,
+ 'twoWay' => true,
+ 'key' => 'libraries',
+ 'twoWayKey' => 'person_one_to_many',
+ ]);
+
+ sleep(1);
+
+ $libraryAttributesResponse = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $libraryCollection . '/columns', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertIsArray($libraryAttributesResponse['body']['columns']);
+ $this->assertEquals(2, $libraryAttributesResponse['body']['total']);
+ $this->assertEquals('person_one_to_many', $libraryAttributesResponse['body']['columns'][1]['key']);
+
+ $libraryCollectionResponse = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $libraryCollection, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertIsArray($libraryCollectionResponse['body']['columns']);
+ $this->assertCount(2, $libraryCollectionResponse['body']['columns']);
+
+ $attribute = $this->client->call(Client::METHOD_GET, "/databases/{$databaseId}/tables/{$personCollection}/columns/libraries", array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals(200, $attribute['headers']['status-code']);
+ $this->assertEquals('available', $attribute['body']['status']);
+ $this->assertEquals('libraries', $attribute['body']['key']);
+ $this->assertEquals('relationship', $attribute['body']['type']);
+ $this->assertEquals(false, $attribute['body']['required']);
+ $this->assertEquals(false, $attribute['body']['array']);
+ $this->assertEquals('oneToMany', $attribute['body']['relationType']);
+ $this->assertEquals(true, $attribute['body']['twoWay']);
+ $this->assertEquals('person_one_to_many', $attribute['body']['twoWayKey']);
+ $this->assertEquals('restrict', $attribute['body']['onDelete']);
+
+ $person2 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $personCollection . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => 'person10',
+ 'data' => [
+ 'fullName' => 'Stevie Wonder',
+ 'libraries' => [
+ [
+ '$id' => 'library10',
+ '$permissions' => [
+ Permission::read(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ 'libraryName' => 'Library 10',
+ ],
+ [
+ '$id' => 'library11',
+ '$permissions' => [
+ Permission::read(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ 'libraryName' => 'Library 11',
+ ]
+ ],
+ ],
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ]
+ ]);
+
+ $this->assertEquals(201, $person2['headers']['status-code']);
+ $this->assertArrayHasKey('libraries', $person2['body']);
+ $this->assertEquals(2, count($person2['body']['libraries']));
+
+ $response = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $personCollection . '/rows/' . $person2['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertArrayNotHasKey('$table', $response['body']);
+ $this->assertArrayHasKey('libraries', $response['body']);
+ $this->assertEquals(2, count($response['body']['libraries']));
+
+ $response = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $libraryCollection . '/rows/library11', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertArrayHasKey('person_one_to_many', $response['body']);
+ $this->assertEquals('person10', $response['body']['person_one_to_many']['$id']);
+
+ $response = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $personCollection . '/columns/libraries/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'onDelete' => Database::RELATION_MUTATE_CASCADE,
+ ]);
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+
+ $attribute = $this->client->call(Client::METHOD_GET, "/databases/{$databaseId}/tables/{$personCollection}/columns/libraries", array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals(200, $attribute['headers']['status-code']);
+ $this->assertEquals('available', $attribute['body']['status']);
+ $this->assertEquals('libraries', $attribute['body']['key']);
+ $this->assertEquals('relationship', $attribute['body']['type']);
+ $this->assertEquals(false, $attribute['body']['required']);
+ $this->assertEquals(false, $attribute['body']['array']);
+ $this->assertEquals('oneToMany', $attribute['body']['relationType']);
+ $this->assertEquals(true, $attribute['body']['twoWay']);
+ $this->assertEquals(Database::RELATION_MUTATE_CASCADE, $attribute['body']['onDelete']);
+
+ return ['databaseId' => $databaseId, 'personCollection' => $personCollection];
+ }
+
+ /**
+ * @depends testCreateDatabase
+ */
+ public function testManyToOneRelationship(array $data): array
+ {
+ $databaseId = $data['databaseId'];
+
+ // Create album table
+ $albums = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Albums',
+ 'rowSecurity' => true,
+ 'permissions' => [
+ Permission::create(Role::user($this->getUser()['$id'])),
+ Permission::read(Role::user($this->getUser()['$id'])),
+ ],
+ ]);
+
+ // Create album name attribute
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $albums['body']['$id'] . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'name',
+ 'size' => 255,
+ 'required' => true,
+ ]);
+
+ // Create artist table
+ $artists = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Artists',
+ 'rowSecurity' => true,
+ 'permissions' => [
+ Permission::create(Role::user($this->getUser()['$id'])),
+ Permission::read(Role::user($this->getUser()['$id'])),
+ ],
+ ]);
+
+ // Create artist name attribute
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $artists['body']['$id'] . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'name',
+ 'size' => 255,
+ 'required' => true,
+ ]);
+
+ // Create relationship
+ $response = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $albums['body']['$id'] . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'relatedTableId' => $artists['body']['$id'],
+ 'type' => Database::RELATION_MANY_TO_ONE,
+ 'twoWay' => true,
+ 'key' => 'artist',
+ 'twoWayKey' => 'albums',
+ ]);
+ $this->assertEquals(202, $response['headers']['status-code']);
+ $this->assertEquals('artist', $response['body']['key']);
+ $this->assertEquals('relationship', $response['body']['type']);
+ $this->assertEquals(false, $response['body']['required']);
+ $this->assertEquals(false, $response['body']['array']);
+ $this->assertEquals('manyToOne', $response['body']['relationType']);
+ $this->assertEquals(true, $response['body']['twoWay']);
+ $this->assertEquals('albums', $response['body']['twoWayKey']);
+ $this->assertEquals('restrict', $response['body']['onDelete']);
+
+ sleep(1); // Wait for worker
+
+ $permissions = [
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::delete(Role::user($this->getUser()['$id'])),
+ ];
+
+ // Create album
+ $album = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $albums['body']['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => 'album1',
+ 'permissions' => $permissions,
+ 'data' => [
+ 'name' => 'Album 1',
+ 'artist' => [
+ '$id' => ID::unique(),
+ 'name' => 'Artist 1',
+ ],
+ ],
+ ]);
+
+ $this->assertEquals(201, $album['headers']['status-code']);
+ $this->assertEquals('album1', $album['body']['$id']);
+ $this->assertEquals('Album 1', $album['body']['name']);
+ $this->assertEquals('Artist 1', $album['body']['artist']['name']);
+ $this->assertEquals($permissions, $album['body']['$permissions']);
+ $this->assertEquals($permissions, $album['body']['artist']['$permissions']);
+
+ $album = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $albums['body']['$id'] . '/rows/album1', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $album['headers']['status-code']);
+ $this->assertEquals('album1', $album['body']['$id']);
+ $this->assertEquals('Album 1', $album['body']['name']);
+ $this->assertEquals('Artist 1', $album['body']['artist']['name']);
+ $this->assertEquals($permissions, $album['body']['$permissions']);
+ $this->assertEquals($permissions, $album['body']['artist']['$permissions']);
+
+ $artist = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $artists['body']['$id'] . '/rows/' . $album['body']['artist']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $artist['headers']['status-code']);
+ $this->assertEquals('Artist 1', $artist['body']['name']);
+ $this->assertEquals($permissions, $artist['body']['$permissions']);
+ $this->assertEquals(1, count($artist['body']['albums']));
+ $this->assertEquals('album1', $artist['body']['albums'][0]['$id']);
+ $this->assertEquals('Album 1', $artist['body']['albums'][0]['name']);
+ $this->assertEquals($permissions, $artist['body']['albums'][0]['$permissions']);
+
+ return [
+ 'databaseId' => $databaseId,
+ 'albumsCollection' => $albums['body']['$id'],
+ 'artistsCollection' => $artists['body']['$id'],
+ ];
+ }
+
+ /**
+ * @depends testCreateDatabase
+ */
+ public function testManyToManyRelationship(array $data): array
+ {
+ $databaseId = $data['databaseId'];
+
+ // Create sports table
+ $sports = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Sports',
+ 'rowSecurity' => true,
+ 'permissions' => [
+ Permission::create(Role::user($this->getUser()['$id'])),
+ Permission::read(Role::user($this->getUser()['$id'])),
+ ],
+ ]);
+
+ // Create sport name attribute
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $sports['body']['$id'] . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'name',
+ 'size' => 255,
+ 'required' => true,
+ ]);
+
+ // Create player table
+ $players = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Players',
+ 'rowSecurity' => true,
+ 'permissions' => [
+ Permission::create(Role::user($this->getUser()['$id'])),
+ Permission::read(Role::user($this->getUser()['$id'])),
+ ],
+ ]);
+
+ // Create player name attribute
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $players['body']['$id'] . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'name',
+ 'size' => 255,
+ 'required' => true,
+ ]);
+
+ // Create relationship
+ $response = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $sports['body']['$id'] . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'relatedTableId' => $players['body']['$id'],
+ 'type' => Database::RELATION_MANY_TO_MANY,
+ 'twoWay' => true,
+ 'key' => 'players',
+ 'twoWayKey' => 'sports',
+ 'onDelete' => Database::RELATION_MUTATE_SET_NULL,
+ ]);
+
+ $this->assertEquals(202, $response['headers']['status-code']);
+ $this->assertEquals('players', $response['body']['key']);
+ $this->assertEquals('relationship', $response['body']['type']);
+ $this->assertEquals(false, $response['body']['required']);
+ $this->assertEquals(false, $response['body']['array']);
+ $this->assertEquals('manyToMany', $response['body']['relationType']);
+ $this->assertEquals(true, $response['body']['twoWay']);
+ $this->assertEquals('sports', $response['body']['twoWayKey']);
+ $this->assertEquals('setNull', $response['body']['onDelete']);
+
+ sleep(1); // Wait for worker
+
+ $permissions = [
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ ];
+
+ // Create sport
+ $sport = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $sports['body']['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => 'sport1',
+ 'permissions' => $permissions,
+ 'data' => [
+ 'name' => 'Sport 1',
+ 'players' => [
+ [
+ '$id' => 'player1',
+ 'name' => 'Player 1',
+ ],
+ [
+ '$id' => 'player2',
+ 'name' => 'Player 2',
+ ]
+ ],
+ ],
+ ]);
+
+ $this->assertEquals(201, $sport['headers']['status-code']);
+ $this->assertEquals('sport1', $sport['body']['$id']);
+ $this->assertEquals('Sport 1', $sport['body']['name']);
+ $this->assertEquals('Player 1', $sport['body']['players'][0]['name']);
+ $this->assertEquals('Player 2', $sport['body']['players'][1]['name']);
+ $this->assertEquals($permissions, $sport['body']['$permissions']);
+ $this->assertEquals($permissions, $sport['body']['players'][0]['$permissions']);
+ $this->assertEquals($permissions, $sport['body']['players'][1]['$permissions']);
+
+ $sport = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $sports['body']['$id'] . '/rows/sport1', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $sport['headers']['status-code']);
+ $this->assertEquals('sport1', $sport['body']['$id']);
+ $this->assertEquals('Sport 1', $sport['body']['name']);
+ $this->assertEquals('Player 1', $sport['body']['players'][0]['name']);
+ $this->assertEquals('Player 2', $sport['body']['players'][1]['name']);
+ $this->assertEquals($permissions, $sport['body']['$permissions']);
+ $this->assertEquals($permissions, $sport['body']['players'][0]['$permissions']);
+ $this->assertEquals($permissions, $sport['body']['players'][1]['$permissions']);
+
+ $player = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $players['body']['$id'] . '/rows/' . $sport['body']['players'][0]['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $player['headers']['status-code']);
+ $this->assertEquals('Player 1', $player['body']['name']);
+ $this->assertEquals($permissions, $player['body']['$permissions']);
+ $this->assertEquals(1, count($player['body']['sports']));
+ $this->assertEquals('sport1', $player['body']['sports'][0]['$id']);
+ $this->assertEquals('Sport 1', $player['body']['sports'][0]['name']);
+ $this->assertEquals($permissions, $player['body']['sports'][0]['$permissions']);
+
+ return [
+ 'databaseId' => $databaseId,
+ 'sportsCollection' => $sports['body']['$id'],
+ 'playersCollection' => $players['body']['$id'],
+ ];
+ }
+
+ /**
+ * @depends testOneToManyRelationship
+ */
+ public function testValidateOperators(array $data): void
+ {
+ $response = $this->client->call(Client::METHOD_GET, '/databases/' . $data['databaseId'] . '/tables/' . $data['personCollection'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::isNotNull('$id')->toString(),
+ Query::startsWith('fullName', 'Stevie')->toString(),
+ Query::endsWith('fullName', 'Wonder')->toString(),
+ Query::between('$createdAt', '1975-12-06', '2050-12-01')->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertEquals(1, count($response['body']['rows']));
+ $this->assertEquals('person10', $response['body']['rows'][0]['$id']);
+ $this->assertEquals('Stevie Wonder', $response['body']['rows'][0]['fullName']);
+ $this->assertEquals(2, count($response['body']['rows'][0]['libraries']));
+
+ $response = $this->client->call(Client::METHOD_GET, '/databases/' . $data['databaseId'] . '/tables/' . $data['personCollection'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::isNotNull('$id')->toString(),
+ Query::isNull('fullName')->toString(),
+ Query::select(['fullName'])->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertEquals(2, count($response['body']['rows']));
+ $this->assertEquals(null, $response['body']['rows'][0]['fullName']);
+ $this->assertArrayNotHasKey("libraries", $response['body']['rows'][0]);
+ $this->assertArrayNotHasKey('$databaseId', $response['body']['rows'][0]);
+ $this->assertArrayNotHasKey('$tableId', $response['body']['rows'][0]);
+ }
+
+ /**
+ * @depends testOneToManyRelationship
+ */
+ public function testSelectQueries(array $data): void
+ {
+ $response = $this->client->call(Client::METHOD_GET, '/databases/' . $data['databaseId'] . '/tables/' . $data['personCollection'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::equal('fullName', ['Stevie Wonder'])->toString(),
+ Query::select(['fullName'])->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertArrayNotHasKey('libraries', $response['body']['rows'][0]);
+ $this->assertArrayNotHasKey('$databaseId', $response['body']['rows'][0]);
+ $this->assertArrayNotHasKey('$tableId', $response['body']['rows'][0]);
+
+ $response = $this->client->call(Client::METHOD_GET, '/databases/' . $data['databaseId'] . '/tables/' . $data['personCollection'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::select(['libraries.*', '$id'])->toString(),
+ ],
+ ]);
+ $row = $response['body']['rows'][0];
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertArrayHasKey('libraries', $row);
+ $this->assertArrayNotHasKey('$databaseId', $row);
+ $this->assertArrayNotHasKey('$tableId', $row);
+
+ $response = $this->client->call(Client::METHOD_GET, '/databases/' . $data['databaseId'] . '/tables/' . $data['personCollection'] . '/rows/' . $row['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::select(['fullName', '$id'])->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertArrayHasKey('fullName', $response['body']);
+ $this->assertArrayNotHasKey('libraries', $response['body']);
+ }
+
+ /**
+ * @throws \Utopia\Database\Exception
+ * @throws \Utopia\Database\Exception\Query
+ */
+ public function testOrQueries(): void
+ {
+ // Create database
+ $database = $this->client->call(Client::METHOD_POST, '/databases', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], [
+ 'databaseId' => ID::unique(),
+ 'name' => 'Or queries'
+ ]);
+
+ $this->assertNotEmpty($database['body']['$id']);
+ $this->assertEquals(201, $database['headers']['status-code']);
+ $this->assertEquals('Or queries', $database['body']['name']);
+
+ $databaseId = $database['body']['$id'];
+
+ // Create Collection
+ $presidents = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'USA Presidents',
+ 'rowSecurity' => true,
+ 'permissions' => [
+ Permission::create(Role::user($this->getUser()['$id'])),
+ ],
+ ]);
+
+ $this->assertEquals(201, $presidents['headers']['status-code']);
+ $this->assertEquals($presidents['body']['name'], 'USA Presidents');
+
+ // Create Attributes
+ $firstName = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $presidents['body']['$id'] . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'first_name',
+ 'size' => 256,
+ 'required' => true,
+ ]);
+ $this->assertEquals(202, $firstName['headers']['status-code']);
+
+ $lastName = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $presidents['body']['$id'] . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'last_name',
+ 'size' => 256,
+ 'required' => true,
+ ]);
+
+ $this->assertEquals(202, $lastName['headers']['status-code']);
+
+ // Wait for worker
+ sleep(2);
+
+ $row1 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $presidents['body']['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'first_name' => 'Donald',
+ 'last_name' => 'Trump',
+ ],
+ 'permissions' => [
+ Permission::read(Role::user($this->getUser()['$id'])),
+ ]
+ ]);
+ $this->assertEquals(201, $row1['headers']['status-code']);
+
+ $row2 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $presidents['body']['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'first_name' => 'George',
+ 'last_name' => 'Bush',
+ ],
+ 'permissions' => [
+ Permission::read(Role::user($this->getUser()['$id'])),
+ ]
+ ]);
+ $this->assertEquals(201, $row2['headers']['status-code']);
+
+ $row3 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $presidents['body']['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'first_name' => 'Joe',
+ 'last_name' => 'Biden',
+ ],
+ 'permissions' => [
+ Permission::read(Role::user($this->getUser()['$id'])),
+ ]
+ ]);
+
+ $this->assertEquals(201, $row3['headers']['status-code']);
+
+ $rows = $this->client->call(
+ Client::METHOD_GET,
+ '/databases/' . $databaseId . '/tables/' . $presidents['body']['$id'] . '/rows',
+ array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()),
+ [
+ 'queries' => [
+ Query::select(['first_name', 'last_name'])->toString(),
+ Query::or([
+ Query::equal('first_name', ['Donald']),
+ Query::equal('last_name', ['Bush'])
+ ])->toString(),
+ Query::limit(999)->toString(),
+ Query::offset(0)->toString()
+ ],
+ ]
+ );
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertCount(2, $rows['body']['rows']);
+ }
+
+ /**
+ * @depends testCreateDatabase
+ * @param array $data
+ * @return void
+ * @throws \Exception
+ */
+ public function testUpdateWithExistingRelationships(array $data): void
+ {
+ $databaseId = $data['databaseId'];
+
+ $table1 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Collection1',
+ 'rowSecurity' => true,
+ 'permissions' => [
+ Permission::create(Role::user($this->getUser()['$id'])),
+ Permission::read(Role::user($this->getUser()['$id'])),
+ ],
+ ]);
+
+ $table2 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Collection2',
+ 'rowSecurity' => true,
+ 'permissions' => [
+ Permission::create(Role::user($this->getUser()['$id'])),
+ Permission::read(Role::user($this->getUser()['$id'])),
+ ],
+ ]);
+
+ $table1 = $table1['body']['$id'];
+ $table2 = $table2['body']['$id'];
+
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table1 . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'name',
+ 'size' => '49',
+ 'required' => true,
+ ]);
+
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table2 . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'name',
+ 'size' => '49',
+ 'required' => true,
+ ]);
+
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table1 . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'relatedTableId' => $table2,
+ 'type' => Database::RELATION_ONE_TO_MANY,
+ 'twoWay' => true,
+ 'key' => 'collection2'
+ ]);
+
+ sleep(1);
+
+ $row = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table1 . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id']
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'name' => 'Document 1',
+ 'collection2' => [
+ [
+ 'name' => 'Document 2',
+ ],
+ ],
+ ],
+ ]);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $table1 . '/rows/' . $row['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id']
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'name' => 'Document 1 Updated',
+ ],
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+ }
+
+ /**
+ * @depends testCreateDatabase
+ */
+ public function testTimeout(array $data): void
+ {
+ $table = $this->client->call(Client::METHOD_POST, '/databases/' . $data['databaseId'] . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Slow Queries',
+ 'rowSecurity' => true,
+ 'permissions' => [
+ Permission::create(Role::user($this->getUser()['$id'])),
+ ],
+ ]);
+
+ $this->assertEquals(201, $table['headers']['status-code']);
+
+ $data = [
+ '$id' => $table['body']['$id'],
+ 'databaseId' => $table['body']['databaseId']
+ ];
+
+ $longtext = $this->client->call(Client::METHOD_POST, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'longtext',
+ 'size' => 100000000,
+ 'required' => false,
+ 'default' => null,
+ ]);
+
+ $this->assertEquals($longtext['headers']['status-code'], 202);
+
+ for ($i = 0; $i < 10; $i++) {
+ $this->client->call(Client::METHOD_POST, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'longtext' => file_get_contents(__DIR__ . '../../../../../resources/longtext.txt'),
+ ],
+ 'permissions' => [
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::delete(Role::user($this->getUser()['$id'])),
+ ]
+ ]);
+ }
+
+ $response = $this->client->call(Client::METHOD_GET, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-timeout' => 1,
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::notEqual('longtext', 'appwrite')->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(408, $response['headers']['status-code']);
+ }
+
+ /**
+ * @throws \Exception
+ */
+ public function testIncrementColumn(): void
+ {
+ $database = $this->client->call(Client::METHOD_POST, '/databases', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], [
+ 'databaseId' => ID::unique(),
+ 'name' => 'CounterDatabase'
+ ]);
+ $databaseId = $database['body']['$id'];
+
+ $table = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'CounterCollection',
+ 'rowSecurity' => true,
+ 'permissions' => [
+ Permission::create(Role::user($this->getUser()['$id'])),
+ Permission::read(Role::user($this->getUser()['$id'])),
+ ],
+ ]);
+ $tableId = $table['body']['$id'];
+
+ // Add integer attribute
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/integer', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'count',
+ 'required' => true,
+ ]);
+
+ \sleep(3);
+
+ // Create row with initial count = 5
+ $doc = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'count' => 5
+ ],
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::update(Role::any()),
+ ],
+ ]);
+ $this->assertEquals(201, $doc['headers']['status-code']);
+
+ $docId = $doc['body']['$id'];
+
+ // Increment by default 1
+ $inc = $this->client->call(Client::METHOD_PATCH, "/databases/$databaseId/tables/$tableId/rows/$docId/count/increment", array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ]));
+ $this->assertEquals(200, $inc['headers']['status-code']);
+ $this->assertEquals(6, $inc['body']['count']);
+
+ // Verify count = 6
+ $get = $this->client->call(Client::METHOD_GET, "/databases/$databaseId/tables/$tableId/rows/$docId", array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+ $this->assertEquals(6, $get['body']['count']);
+
+ // Increment by custom value 4
+ $inc2 = $this->client->call(Client::METHOD_PATCH, "/databases/$databaseId/tables/$tableId/rows/$docId/count/increment", array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ]), [
+ 'value' => 4
+ ]);
+ $this->assertEquals(200, $inc2['headers']['status-code']);
+ $this->assertEquals(10, $inc2['body']['count']);
+
+ $get2 = $this->client->call(Client::METHOD_GET, "/databases/$databaseId/tables/$tableId/rows/$docId", array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+ $this->assertEquals(10, $get2['body']['count']);
+
+ // Test max limit exceeded
+ $err = $this->client->call(Client::METHOD_PATCH, "/databases/$databaseId/tables/$tableId/rows/$docId/count/increment", array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ]), ['max' => 8]);
+ $this->assertEquals(400, $err['headers']['status-code']);
+
+ // Test attribute not found
+ $notFound = $this->client->call(Client::METHOD_PATCH, "/databases/$databaseId/tables/$tableId/rows/$docId/unknown/increment", array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ]));
+ $this->assertEquals(404, $notFound['headers']['status-code']);
+ }
+
+ public function testDecrementColumn(): void
+ {
+ $database = $this->client->call(Client::METHOD_POST, '/databases', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], [
+ 'databaseId' => ID::unique(),
+ 'name' => 'CounterDatabase'
+ ]);
+
+ $databaseId = $database['body']['$id'];
+
+ $table = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'CounterCollection',
+ 'rowSecurity' => true,
+ 'permissions' => [
+ Permission::create(Role::user($this->getUser()['$id'])),
+ Permission::read(Role::user($this->getUser()['$id'])),
+ ],
+ ]);
+
+ $tableId = $table['body']['$id'];
+
+ // Add integer attribute
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/integer', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'count',
+ 'required' => true,
+ ]);
+
+ \sleep(2);
+
+ // Create row with initial count = 10
+ $doc = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => ['count' => 10],
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::update(Role::any()),
+ ],
+ ]);
+
+ $rowId = $doc['body']['$id'];
+
+ // Decrement by default 1 (count = 10 -> 9)
+ $dec = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows/' . $rowId . '/count/decrement', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ]));
+ $this->assertEquals(200, $dec['headers']['status-code']);
+ $this->assertEquals(9, $dec['body']['count']);
+
+ $get = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows/' . $rowId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+ $this->assertEquals(9, $get['body']['count']);
+
+ // Decrement by custom value 3 (count 9 -> 6)
+ $dec2 = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows/' . $rowId . '/count/decrement', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ]), [
+ 'value' => 3
+ ]);
+ $this->assertEquals(200, $dec2['headers']['status-code']);
+ $this->assertEquals(6, $dec2['body']['count']);
+
+ $get2 = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows/' . $rowId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+ $this->assertEquals(6, $get2['body']['count']);
+
+ // Test min limit exceeded
+ $err = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows/' . $rowId . '/count/decrement', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ]), ['min' => 7]);
+ $this->assertEquals(400, $err['headers']['status-code']);
+
+ // Test type error on non-numeric attribute
+ $typeErr = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows/' . $rowId . '/count/decrement', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ]), ['value' => 'not-a-number']);
+ $this->assertEquals(400, $typeErr['headers']['status-code']);
+ }
+}
diff --git a/tests/e2e/Services/Databases/Tables/DatabasesConsoleClientTest.php b/tests/e2e/Services/Databases/Tables/DatabasesConsoleClientTest.php
new file mode 100644
index 0000000000..8a8d8de170
--- /dev/null
+++ b/tests/e2e/Services/Databases/Tables/DatabasesConsoleClientTest.php
@@ -0,0 +1,336 @@
+client->call(Client::METHOD_POST, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'databaseId' => ID::unique(),
+ 'name' => 'invalidDocumentDatabase',
+ ]);
+ $this->assertEquals(201, $database['headers']['status-code']);
+ $this->assertEquals('invalidDocumentDatabase', $database['body']['name']);
+ $this->assertTrue($database['body']['enabled']);
+
+ $databaseId = $database['body']['$id'];
+
+ /**
+ * Test for SUCCESS
+ */
+ $movies = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Movies',
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::create(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ 'rowSecurity' => true,
+ ]);
+
+ $this->assertEquals(201, $movies['headers']['status-code']);
+ $this->assertEquals('Movies', $movies['body']['name']);
+
+ /**
+ * Test when database is disabled but can still create tables
+ */
+ $database = $this->client->call(Client::METHOD_PUT, '/databases/' . $databaseId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'name' => 'invalidDocumentDatabase Updated',
+ 'enabled' => false,
+ ]);
+
+ $this->assertFalse($database['body']['enabled']);
+
+ $tvShows = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'tableId' => ID::unique(),
+ 'name' => 'TvShows',
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::create(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ 'rowSecurity' => true,
+ ]);
+
+ /**
+ * Test when table is disabled but can still modify tables
+ */
+ $database = $this->client->call(Client::METHOD_PUT, '/databases/' . $databaseId . '/tables/' . $movies['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'name' => 'Movies',
+ 'enabled' => false,
+ ]);
+
+ $this->assertEquals(201, $tvShows['headers']['status-code']);
+ $this->assertEquals('TvShows', $tvShows['body']['name']);
+
+ return ['moviesId' => $movies['body']['$id'], 'databaseId' => $databaseId, 'tvShowsId' => $tvShows['body']['$id']];
+ }
+
+ /**
+ * @depends testCreateTable
+ * @param array $data
+ * @throws \Exception
+ */
+ public function testListTable(array $data)
+ {
+ /**
+ * Test when database is disabled but can still call list tables
+ */
+ $databaseId = $data['databaseId'];
+
+ $tables = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id']
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $tables['headers']['status-code']);
+ $this->assertEquals(2, $tables['body']['total']);
+ }
+
+ /**
+ * @depends testCreateTable
+ * @param array $data
+ * @throws \Exception
+ */
+ public function testGetTable(array $data)
+ {
+ $databaseId = $data['databaseId'];
+ $moviesCollectionId = $data['moviesId'];
+
+ /**
+ * Test when database and table are disabled but can still call get table
+ */
+ $table = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $moviesCollectionId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $table['headers']['status-code']);
+ $this->assertEquals('Movies', $table['body']['name']);
+ $this->assertEquals($moviesCollectionId, $table['body']['$id']);
+ $this->assertFalse($table['body']['enabled']);
+ }
+
+ /**
+ * @depends testCreateTable
+ * @param array $data
+ * @throws \Exception
+ * @throws \Exception
+ */
+ public function testUpdateTable(array $data)
+ {
+ $databaseId = $data['databaseId'];
+ $moviesCollectionId = $data['moviesId'];
+
+ /**
+ * Test When database and table are disabled but can still call update table
+ */
+ $table = $this->client->call(Client::METHOD_PUT, '/databases/' . $databaseId . '/tables/' . $moviesCollectionId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'name' => 'Movies Updated',
+ 'enabled' => false
+ ]);
+
+ $this->assertEquals(200, $table['headers']['status-code']);
+ $this->assertEquals('Movies Updated', $table['body']['name']);
+ $this->assertEquals($moviesCollectionId, $table['body']['$id']);
+ $this->assertFalse($table['body']['enabled']);
+ }
+
+ /**
+ * @depends testCreateTable
+ * @param array $data
+ * @throws \Exception
+ * @throws \Exception
+ */
+ public function testDeleteTable(array $data)
+ {
+ $databaseId = $data['databaseId'];
+ $tvShowsId = $data['tvShowsId'];
+
+ /**
+ * Test when database and table are disabled but can still call delete table
+ */
+ $response = $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $tvShowsId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(204, $response['headers']['status-code']);
+ $this->assertEquals("", $response['body']);
+ }
+
+ /**
+ * @depends testCreateTable
+ */
+ public function testGetDatabaseUsage(array $data)
+ {
+ $databaseId = $data['databaseId'];
+ /**
+ * Test for FAILURE
+ */
+
+ $response = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/usage', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id']
+ ], $this->getHeaders()), [
+ 'range' => '32h'
+ ]);
+
+ $this->assertEquals(400, $response['headers']['status-code']);
+
+ /**
+ * Test for SUCCESS
+ */
+
+ $response = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/usage', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id']
+ ], $this->getHeaders()), [
+ 'range' => '24h'
+ ]);
+
+
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertCount(15, $response['body']);
+ $this->assertEquals('24h', $response['body']['range']);
+ $this->assertIsNumeric($response['body']['rowsTotal']);
+ $this->assertIsNumeric($response['body']['tablesTotal']);
+ $this->assertIsArray($response['body']['tables']);
+ $this->assertIsArray($response['body']['rows']);
+ }
+
+
+ /**
+ * @depends testCreateTable
+ */
+ public function testGetTableUsage(array $data)
+ {
+ $databaseId = $data['databaseId'];
+ /**
+ * Test for FAILURE
+ */
+
+ $response = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/usage', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id']
+ ], $this->getHeaders()), [
+ 'range' => '32h'
+ ]);
+
+ $this->assertEquals(400, $response['headers']['status-code']);
+
+ $response = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/randomCollectionId/usage', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id']
+ ], $this->getHeaders()), [
+ 'range' => '24h'
+ ]);
+
+ $this->assertEquals(404, $response['headers']['status-code']);
+
+ /**
+ * Test for SUCCESS
+ */
+ $response = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/usage', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id']
+ ], $this->getHeaders()), [
+ 'range' => '24h'
+ ]);
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertEquals(3, count($response['body']));
+ $this->assertEquals('24h', $response['body']['range']);
+ $this->assertIsNumeric($response['body']['rowsTotal']);
+ $this->assertIsArray($response['body']['rows']);
+ }
+
+ /**
+ * @depends testCreateTable
+ * @throws \Utopia\Database\Exception\Query
+ */
+ public function testGetTableLogs(array $data)
+ {
+ $databaseId = $data['databaseId'];
+ /**
+ * Test for SUCCESS
+ */
+ $logs = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/logs', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $logs['headers']['status-code']);
+ $this->assertIsArray($logs['body']['logs']);
+ $this->assertIsNumeric($logs['body']['total']);
+
+ $logs = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/logs', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [Query::limit(1)->toString()]
+ ]);
+
+ $this->assertEquals(200, $logs['headers']['status-code']);
+ $this->assertIsArray($logs['body']['logs']);
+ $this->assertLessThanOrEqual(1, count($logs['body']['logs']));
+ $this->assertIsNumeric($logs['body']['total']);
+
+ $logs = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/logs', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [Query::offset(1)->toString()]
+ ]);
+
+ $this->assertEquals(200, $logs['headers']['status-code']);
+ $this->assertIsArray($logs['body']['logs']);
+ $this->assertIsNumeric($logs['body']['total']);
+
+ $logs = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['moviesId'] . '/logs', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [Query::offset(1)->toString(), Query::limit(1)->toString()]
+ ]);
+
+ $this->assertEquals(200, $logs['headers']['status-code']);
+ $this->assertIsArray($logs['body']['logs']);
+ $this->assertLessThanOrEqual(1, count($logs['body']['logs']));
+ $this->assertIsNumeric($logs['body']['total']);
+ }
+}
diff --git a/tests/e2e/Services/Databases/Tables/DatabasesCustomClientTest.php b/tests/e2e/Services/Databases/Tables/DatabasesCustomClientTest.php
new file mode 100644
index 0000000000..6893588934
--- /dev/null
+++ b/tests/e2e/Services/Databases/Tables/DatabasesCustomClientTest.php
@@ -0,0 +1,893 @@
+client->call(Client::METHOD_POST, '/databases', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], [
+ 'databaseId' => ID::unique(),
+ 'name' => 'Test Database'
+ ]);
+
+ $databaseId = $database['body']['$id'];
+
+ // Collection aliases write to create, update, delete
+ $movies = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Movies',
+ 'rowSecurity' => true,
+ 'permissions' => [
+ Permission::write(Role::user($this->getUser()['$id'])),
+ ],
+ ]);
+
+ $moviesId = $movies['body']['$id'];
+
+ $this->assertContains(Permission::create(Role::user($this->getUser()['$id'])), $movies['body']['$permissions']);
+ $this->assertContains(Permission::update(Role::user($this->getUser()['$id'])), $movies['body']['$permissions']);
+ $this->assertContains(Permission::delete(Role::user($this->getUser()['$id'])), $movies['body']['$permissions']);
+
+ $response = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $moviesId . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'title',
+ 'size' => 256,
+ 'required' => true,
+ ]);
+
+ sleep(1);
+
+ $this->assertEquals(202, $response['headers']['status-code']);
+
+ // Document aliases write to update, delete
+ $row1 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $moviesId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Captain America',
+ ],
+ 'permissions' => [
+ Permission::write(Role::user($this->getUser()['$id'])),
+ ]
+ ]);
+
+ $this->assertNotContains(Permission::create(Role::user($this->getUser()['$id'])), $row1['body']['$permissions']);
+ $this->assertContains(Permission::update(Role::user($this->getUser()['$id'])), $row1['body']['$permissions']);
+ $this->assertContains(Permission::delete(Role::user($this->getUser()['$id'])), $row1['body']['$permissions']);
+
+ /**
+ * Test for FAILURE
+ */
+
+ // Document does not allow create permission
+ $row2 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $moviesId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Captain America',
+ ],
+ 'permissions' => [
+ Permission::create(Role::user($this->getUser()['$id'])),
+ ]
+ ]);
+
+ $this->assertEquals(400, $row2['headers']['status-code']);
+ }
+
+ public function testUpdateWithoutPermission(): array
+ {
+ // If document has been created by server and client tried to update it without adjusting permissions, permission validation should be skipped
+
+ // As a part of preparation, we get ID of currently logged-in user
+ $response = $this->client->call(Client::METHOD_GET, '/account', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+ $this->assertEquals(200, $response['headers']['status-code']);
+
+ $userId = $response['body']['$id'];
+
+ $database = $this->client->call(Client::METHOD_POST, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'databaseId' => ID::custom('permissionCheckDatabase'),
+ 'name' => 'Test Database',
+ ]);
+ $this->assertEquals(201, $database['headers']['status-code']);
+ $this->assertEquals('Test Database', $database['body']['name']);
+
+ $databaseId = $database['body']['$id'];
+ // Create collection
+ $response = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::custom('permissionCheck'),
+ 'name' => 'permissionCheck',
+ 'permissions' => [],
+ 'rowSecurity' => true,
+ ]);
+ $this->assertEquals(201, $response['headers']['status-code']);
+
+ // Add attribute to collection
+ $response = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/permissionCheck/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'name',
+ 'size' => 255,
+ 'required' => true,
+ ]);
+ $this->assertEquals(202, $response['headers']['status-code']);
+
+ // Wait for database worker to finish creating attributes
+ sleep(2);
+
+ // Creating document by server, give read permission to our user + some other user
+ $response = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/permissionCheck/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'rowId' => ID::custom('permissionCheckDocument'),
+ 'data' => [
+ 'name' => 'AppwriteBeginner',
+ ],
+ 'permissions' => [
+ Permission::read(Role::user(ID::custom('user2'))),
+ Permission::read(Role::user($userId)),
+ Permission::update(Role::user($userId)),
+ Permission::delete(Role::user($userId)),
+ ],
+ ]);
+
+ $this->assertEquals(201, $response['headers']['status-code']);
+
+ // Update document
+ // This is the point of this test. We should be allowed to do this action, and it should not fail on permission check
+ $response = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/permissionCheck/rows/permissionCheckDocument', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'name' => 'AppwriteExpert',
+ ]
+ ]);
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+
+ // Get name of the document, should be the new one
+ $response = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/permissionCheck/rows/permissionCheckDocument', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertEquals("AppwriteExpert", $response['body']['name']);
+
+ // Cleanup to prevent collision with other tests
+ // Delete collection
+ $response = $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/permissionCheck', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals(204, $response['headers']['status-code']);
+
+
+ // Wait for database worker to finish deleting collection
+ sleep(2);
+
+ // Make sure collection has been deleted
+ $response = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/permissionCheck', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+ $this->assertEquals(404, $response['headers']['status-code']);
+
+ return [];
+ }
+
+ public function testUpdateTwoWayRelationship(): void
+ {
+
+ $database = $this->client->call(Client::METHOD_POST, '/databases', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], [
+ 'databaseId' => ID::unique(),
+ 'name' => 'Test Database'
+ ]);
+
+ $databaseId = $database['body']['$id'];
+
+
+ // Creating collection 1
+ $table1 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'level1',
+ 'rowSecurity' => false,
+ 'permissions' => [
+ Permission::create(Role::user($this->getUser()['$id'])),
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::delete(Role::user($this->getUser()['$id'])),
+ ]
+ ]);
+
+ // Creating collection 2
+ $table2 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'level2',
+ 'rowSecurity' => false,
+ 'permissions' => [
+ Permission::create(Role::user($this->getUser()['$id'])),
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::delete(Role::user($this->getUser()['$id'])),
+ ]
+ ]);
+
+ \sleep(2);
+
+ // Creating two way relationship between collection 1 and collection 2 from collection 1
+ $relation = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table1['body']['$id'] . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'relatedTableId' => $table2['body']['$id'],
+ 'type' => 'oneToMany',
+ 'twoWay' => true,
+ 'onDelete' => 'cascade',
+ 'key' => $table2['body']['$id'],
+ 'twoWayKey' => $table1['body']['$id']
+ ]);
+
+ \sleep(3);
+
+ // Update relation from collection 2 to on delete restrict
+ $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $table2['body']['$id'] . '/columns/' . $table1['body']['$id'] . '/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'onDelete' => 'restrict',
+ ]);
+
+ // Fetching attributes after updating relation to compare
+ $table1Attributes = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $table1['body']['$id'], [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]);
+
+ $table1RelationAttribute = $table1Attributes['body']['columns'][0];
+
+ $this->assertEquals($relation['body']['side'], $table1RelationAttribute['side']);
+ $this->assertEquals($relation['body']['twoWayKey'], $table1RelationAttribute['twoWayKey']);
+ $this->assertEquals($relation['body']['relatedTable'], $table1RelationAttribute['relatedTable']);
+ $this->assertEquals('restrict', $table1RelationAttribute['onDelete']);
+ }
+
+ public function testRelationshipSameTwoWayKey(): void
+ {
+ $database = $this->client->call(Client::METHOD_POST, '/databases', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], [
+ 'databaseId' => ID::unique(),
+ 'name' => 'Same two way key'
+ ]);
+
+ $databaseId = $database['body']['$id'];
+
+ $table1 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'c1',
+ 'rowSecurity' => false,
+ 'permissions' => [
+ Permission::create(Role::user($this->getUser()['$id'])),
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::delete(Role::user($this->getUser()['$id'])),
+ ]
+ ]);
+
+ $table2 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'c2',
+ 'rowSecurity' => false,
+ 'permissions' => [
+ Permission::create(Role::user($this->getUser()['$id'])),
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::delete(Role::user($this->getUser()['$id'])),
+ ]
+ ]);
+
+ \sleep(2);
+
+ $relation = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table1['body']['$id'] . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'relatedTableId' => $table2['body']['$id'],
+ 'type' => Database::RELATION_ONE_TO_ONE,
+ 'twoWay' => false,
+ 'onDelete' => 'cascade',
+ 'key' => 'attr1',
+ 'twoWayKey' => 'same_key'
+ ]);
+
+ \sleep(2);
+
+ $this->assertEquals(202, $relation['headers']['status-code']);
+ $this->assertEquals('same_key', $relation['body']['twoWayKey']);
+
+ $relation = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table1['body']['$id'] . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'relatedTableId' => $table2['body']['$id'],
+ 'type' => Database::RELATION_ONE_TO_MANY,
+ 'twoWay' => false,
+ 'onDelete' => 'cascade',
+ 'key' => 'attr2',
+ 'twoWayKey' => 'same_key'
+ ]);
+
+ \sleep(2);
+
+ $this->assertEquals(409, $relation['body']['code']);
+ $this->assertEquals('Attribute with the requested key already exists. Attribute keys must be unique, try again with a different key.', $relation['body']['message']);
+
+ // twoWayKey is null TwoWayKey is default
+ $relation = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table1['body']['$id'] . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'relatedTableId' => $table2['body']['$id'],
+ 'type' => Database::RELATION_ONE_TO_MANY,
+ 'twoWay' => false,
+ 'onDelete' => 'cascade',
+ 'key' => 'attr3',
+ ]);
+
+ \sleep(2);
+
+ $this->assertEquals(202, $relation['headers']['status-code']);
+ $this->assertArrayHasKey('twoWayKey', $relation['body']);
+
+ // twoWayKey is null, TwoWayKey is default, second POST
+ $relation = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table1['body']['$id'] . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'relatedTableId' => $table2['body']['$id'],
+ 'type' => Database::RELATION_ONE_TO_MANY,
+ 'twoWay' => false,
+ 'onDelete' => 'cascade',
+ 'key' => 'attr4',
+ ]);
+
+ \sleep(2);
+
+ $this->assertEquals('Attribute with the requested key already exists. Attribute keys must be unique, try again with a different key.', $relation['body']['message']);
+ $this->assertEquals(409, $relation['body']['code']);
+
+ // RelationshipManyToMany
+ $relation = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table1['body']['$id'] . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'relatedTableId' => $table2['body']['$id'],
+ 'type' => Database::RELATION_MANY_TO_MANY,
+ 'twoWay' => true,
+ 'onDelete' => 'setNull',
+ 'key' => 'songs',
+ 'twoWayKey' => 'playlist',
+ ]);
+
+ \sleep(2);
+
+ $this->assertEquals(202, $relation['headers']['status-code']);
+ $this->assertArrayHasKey('twoWayKey', $relation['body']);
+
+ // Second RelationshipManyToMany on Same collections
+ $relation = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table1['body']['$id'] . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'relatedTableId' => $table2['body']['$id'],
+ 'type' => Database::RELATION_MANY_TO_MANY,
+ 'twoWay' => true,
+ 'onDelete' => 'setNull',
+ 'key' => 'songs2',
+ 'twoWayKey' => 'playlist2',
+ ]);
+
+ \sleep(2);
+
+ $this->assertEquals(409, $relation['body']['code']);
+ $this->assertEquals('Creating more than one "manyToMany" relationship on the same table is currently not permitted.', $relation['body']['message']);
+ }
+
+ public function testUpdateWithoutRelationPermission(): void
+ {
+ $userId = $this->getUser()['$id'];
+ $database = $this->client->call(Client::METHOD_POST, '/databases', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], [
+ 'databaseId' => ID::unique(),
+ 'name' => ID::unique(),
+ ]);
+
+ $databaseId = $database['body']['$id'];
+
+ // Creating collection 1
+ $table1 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::custom('collection1'),
+ 'name' => ID::custom('collection1'),
+ 'rowSecurity' => false,
+ 'permissions' => [
+ Permission::create(Role::user($userId)),
+ Permission::read(Role::user($userId)),
+ Permission::delete(Role::user($userId)),
+ ]
+ ]);
+
+ // Creating collection 2
+ $table2 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::custom('collection2'),
+ 'name' => ID::custom('collection2'),
+ 'rowSecurity' => false,
+ 'permissions' => [
+ Permission::read(Role::user($userId)),
+ ]
+ ]);
+
+ $table3 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::custom('collection3'),
+ 'name' => ID::custom('collection3'),
+ 'rowSecurity' => false,
+ 'permissions' => [
+ Permission::create(Role::user($userId)),
+ Permission::read(Role::user($userId)),
+ Permission::delete(Role::user($userId)),
+ ]
+ ]);
+
+ $table4 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::custom('collection4'),
+ 'name' => ID::custom('collection4'),
+ 'rowSecurity' => false,
+ 'permissions' => [
+ Permission::read(Role::user($userId)),
+ ]
+ ]);
+
+ $table5 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::custom('collection5'),
+ 'name' => ID::custom('collection5'),
+ 'rowSecurity' => false,
+ 'permissions' => [
+ Permission::create(Role::user($userId)),
+ Permission::read(Role::user($userId)),
+ Permission::delete(Role::user($userId)),
+ ]
+ ]);
+
+ // Creating one to one relationship from collection 1 to colletion 2
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table1['body']['$id'] . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'relatedTableId' => $table2['body']['$id'],
+ 'type' => 'oneToOne',
+ 'twoWay' => false,
+ 'onDelete' => 'setNull',
+ 'key' => $table2['body']['$id']
+ ]);
+
+ // Creating one to one relationship from collection 2 to colletion 3
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table2['body']['$id'] . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'relatedTableId' => $table3['body']['$id'],
+ 'type' => 'oneToOne',
+ 'twoWay' => false,
+ 'onDelete' => 'setNull',
+ 'key' => $table3['body']['$id']
+ ]);
+
+ // Creating one to one relationship from collection 3 to colletion 4
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table3['body']['$id'] . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'relatedTableId' => $table4['body']['$id'],
+ 'type' => 'oneToOne',
+ 'twoWay' => false,
+ 'onDelete' => 'setNull',
+ 'key' => $table4['body']['$id']
+ ]);
+
+ // Creating one to one relationship from collection 4 to colletion 5
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table4['body']['$id'] . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'relatedTableId' => $table5['body']['$id'],
+ 'type' => 'oneToOne',
+ 'twoWay' => false,
+ 'onDelete' => 'setNull',
+ 'key' => $table5['body']['$id']
+ ]);
+
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table1['body']['$id'] . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => "Title",
+ 'size' => 100,
+ 'required' => false,
+ 'array' => false,
+ 'default' => null,
+ ]);
+
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table2['body']['$id'] . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => "Rating",
+ 'size' => 100,
+ 'required' => false,
+ 'array' => false,
+ 'default' => null,
+ ]);
+
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table3['body']['$id'] . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => "Rating",
+ 'size' => 100,
+ 'required' => false,
+ 'array' => false,
+ 'default' => null,
+ ]);
+
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table4['body']['$id'] . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => "Rating",
+ 'size' => 100,
+ 'required' => false,
+ 'array' => false,
+ 'default' => null,
+ ]);
+
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table5['body']['$id'] . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => "Rating",
+ 'size' => 100,
+ 'required' => false,
+ 'array' => false,
+ 'default' => null,
+ ]);
+
+ \sleep(2);
+ // Creating parent document with a child reference to test the permissions
+ $parentDocument = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table1['body']['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'rowId' => ID::custom($table1['body']['$id']),
+ 'data' => [
+ 'Title' => 'Captain America',
+ $table2['body']['$id'] => [
+ '$id' => ID::custom($table2['body']['$id']),
+ 'Rating' => '10',
+ $table3['body']['$id'] => [
+ '$id' => ID::custom($table3['body']['$id']),
+ 'Rating' => '10',
+ $table4['body']['$id'] => [
+ '$id' => ID::custom($table4['body']['$id']),
+ 'Rating' => '10',
+ $table5['body']['$id'] => [
+ '$id' => ID::custom($table5['body']['$id']),
+ 'Rating' => '10'
+ ]
+ ]
+ ]
+ ]
+ ]
+ ]);
+
+ $this->assertEquals(201, $parentDocument['headers']['status-code']);
+ // This is the point of the test. We should not need any authorization permission to update the document with same data.
+ $response = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $table1['body']['$id'] . '/rows/' . $table1['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::custom($table1['body']['$id']),
+ 'data' => [
+ 'Title' => 'Captain America',
+ $table2['body']['$id'] => [
+ '$id' => $table2['body']['$id'],
+ 'Rating' => '10',
+ $table3['body']['$id'] => [
+ '$id' => $table3['body']['$id'],
+ 'Rating' => '10',
+ $table4['body']['$id'] => [
+ '$id' => $table4['body']['$id'],
+ 'Rating' => '10',
+ $table5['body']['$id'] => [
+ '$id' => $table5['body']['$id'],
+ 'Rating' => '10'
+ ]
+ ]
+ ]
+ ]
+ ]
+ ]);
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertEquals($parentDocument['body'], $response['body']);
+
+ // Giving update permission of collection 3 to user.
+ $this->client->call(Client::METHOD_PUT, '/databases/' . $databaseId . '/tables/collection3', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::custom('collection3'),
+ 'name' => ID::custom('collection3'),
+ 'rowSecurity' => false,
+ 'permissions' => [
+ Permission::create(Role::user($userId)),
+ Permission::read(Role::user($userId)),
+ Permission::update(Role::user($userId)),
+ Permission::delete(Role::user($userId)),
+ ]
+ ]);
+
+ // This is the point of this test. We should be allowed to do this action, and it should not fail on permission check
+ $response = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $table1['body']['$id'] . '/rows/' . $table1['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'Title' => 'Captain America',
+ $table2['body']['$id'] => [
+ '$id' => ID::custom($table2['body']['$id']),
+ 'Rating' => '10',
+ $table3['body']['$id'] => [
+ '$id' => ID::custom($table3['body']['$id']),
+ 'Rating' => '11',
+ $table4['body']['$id'] => [
+ '$id' => ID::custom($table4['body']['$id']),
+ 'Rating' => '10',
+ $table5['body']['$id'] => [
+ '$id' => ID::custom($table5['body']['$id']),
+ 'Rating' => '11'
+ ]
+ ]
+ ]
+ ]
+ ]
+ ]);
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertEquals(11, $response['body'][$table2['body']['$id']]['collection3']['Rating']);
+
+ // We should not be allowed to update the document as we do not have permission for collection 2.
+ $response = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $table1['body']['$id'] . '/rows/' . $table1['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'Title' => 'Captain America',
+ $table2['body']['$id'] => [
+ '$id' => ID::custom($table2['body']['$id']),
+ 'Rating' => '11',
+ $table3['body']['$id'] => null,
+ ]
+ ]
+ ]);
+
+ $this->assertEquals(401, $response['headers']['status-code']);
+
+ // We should not be allowed to update the document as we do not have permission for collection 2.
+ $response = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $table2['body']['$id'] . '/rows/' . $table2['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'Rating' => '11',
+ ]
+ ]);
+
+ $this->assertEquals(401, $response['headers']['status-code']);
+
+ // Removing update permission from collection 3.
+ $this->client->call(Client::METHOD_PUT, '/databases/' . $databaseId . '/tables/collection3', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::custom('collection3'),
+ 'name' => ID::custom('collection3'),
+ 'rowSecurity' => false,
+ 'permissions' => [
+ Permission::create(Role::user($userId)),
+ Permission::read(Role::user($userId)),
+ Permission::delete(Role::user($userId)),
+ ]
+ ]);
+
+ // Giving update permission to collection 2.
+ $this->client->call(Client::METHOD_PUT, '/databases/' . $databaseId . '/tables/collection2', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::custom('collection2'),
+ 'name' => ID::custom('collection2'),
+ 'rowSecurity' => false,
+ 'permissions' => [
+ Permission::create(Role::user($userId)),
+ Permission::update(Role::user($userId)),
+ Permission::read(Role::user($userId)),
+ Permission::delete(Role::user($userId)),
+ ]
+ ]);
+
+ // Creating collection 3 new document
+ $response = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table3['body']['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'rowId' => ID::custom('collection3Doc1'),
+ 'data' => [
+ 'Rating' => '20'
+ ]
+ ]);
+
+ $this->assertEquals(201, $response['headers']['status-code']);
+
+ // We should be allowed to link a new document from collection 3 to collection 2.
+ $response = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $table1['body']['$id'] . '/rows/' . $table1['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'Title' => 'Captain America',
+ $table2['body']['$id'] => [
+ '$id' => ID::custom($table2['body']['$id']),
+ $table3['body']['$id'] => 'collection3Doc1',
+ ]
+ ]
+ ]);
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+
+
+ // We should be allowed to link and create a new document from collection 3 to collection 2.
+ $response = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $table1['body']['$id'] . '/rows/' . $table1['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'Title' => 'Captain America',
+ $table2['body']['$id'] => [
+ '$id' => ID::custom($table2['body']['$id']),
+ $table3['body']['$id'] => [
+ '$id' => ID::custom('collection3Doc2')
+ ],
+ ]
+ ]
+ ]);
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ }
+}
diff --git a/tests/e2e/Services/Databases/Tables/DatabasesCustomServerTest.php b/tests/e2e/Services/Databases/Tables/DatabasesCustomServerTest.php
new file mode 100644
index 0000000000..710b167b64
--- /dev/null
+++ b/tests/e2e/Services/Databases/Tables/DatabasesCustomServerTest.php
@@ -0,0 +1,5152 @@
+client->call(Client::METHOD_POST, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'databaseId' => ID::custom('first'),
+ 'name' => 'Test 1',
+ ]);
+
+ $this->assertEquals(201, $test1['headers']['status-code']);
+ $this->assertEquals('Test 1', $test1['body']['name']);
+
+ $test2 = $this->client->call(Client::METHOD_POST, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'databaseId' => ID::custom('second'),
+ 'name' => 'Test 2',
+ ]);
+ $this->assertEquals(201, $test2['headers']['status-code']);
+ $this->assertEquals('Test 2', $test2['body']['name']);
+
+ $databases = $this->client->call(Client::METHOD_GET, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(2, $databases['body']['total']);
+ $this->assertEquals($test1['body']['$id'], $databases['body']['databases'][0]['$id']);
+ $this->assertEquals($test2['body']['$id'], $databases['body']['databases'][1]['$id']);
+
+ $base = array_reverse($databases['body']['databases']);
+
+ $databases = $this->client->call(Client::METHOD_GET, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::limit(1)->toString(),
+ ],
+ ]);
+ $this->assertEquals(200, $databases['headers']['status-code']);
+ $this->assertCount(1, $databases['body']['databases']);
+
+ $databases = $this->client->call(Client::METHOD_GET, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::offset(1)->toString(),
+ ],
+ ]);
+ $this->assertEquals(200, $databases['headers']['status-code']);
+ $this->assertCount(1, $databases['body']['databases']);
+
+ $databases = $this->client->call(Client::METHOD_GET, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::equal('name', ['Test 1', 'Test 2'])->toString(),
+ ],
+ ]);
+ $this->assertEquals(200, $databases['headers']['status-code']);
+ $this->assertCount(2, $databases['body']['databases']);
+
+ $databases = $this->client->call(Client::METHOD_GET, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::equal('name', ['Test 2'])->toString(),
+ ],
+ ]);
+ $this->assertEquals(200, $databases['headers']['status-code']);
+ $this->assertCount(1, $databases['body']['databases']);
+
+ $databases = $this->client->call(Client::METHOD_GET, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::equal('$id', ['first'])->toString(),
+ ],
+ ]);
+ $this->assertEquals(200, $databases['headers']['status-code']);
+ $this->assertCount(1, $databases['body']['databases']);
+
+ /**
+ * Test for Order
+ */
+ $databases = $this->client->call(Client::METHOD_GET, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::orderDesc()->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(2, $databases['body']['total']);
+ $this->assertEquals($base[0]['$id'], $databases['body']['databases'][0]['$id']);
+ $this->assertEquals($base[1]['$id'], $databases['body']['databases'][1]['$id']);
+
+ /**
+ * Test for After
+ */
+ $base = $this->client->call(Client::METHOD_GET, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $databases = $this->client->call(Client::METHOD_GET, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::cursorAfter(new Document(['$id' => $base['body']['databases'][0]['$id']]))->toString(),
+ ],
+ ]);
+
+ $this->assertCount(1, $databases['body']['databases']);
+ $this->assertEquals($base['body']['databases'][1]['$id'], $databases['body']['databases'][0]['$id']);
+
+ $databases = $this->client->call(Client::METHOD_GET, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::cursorAfter(new Document(['$id' => $base['body']['databases'][1]['$id']]))->toString(),
+ ],
+ ]);
+
+ $this->assertCount(0, $databases['body']['databases']);
+ $this->assertEmpty($databases['body']['databases']);
+
+ /**
+ * Test for Before
+ */
+ $base = $this->client->call(Client::METHOD_GET, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $databases = $this->client->call(Client::METHOD_GET, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::cursorBefore(new Document(['$id' => $base['body']['databases'][1]['$id']]))->toString(),
+ ],
+ ]);
+
+ $this->assertCount(1, $databases['body']['databases']);
+ $this->assertEquals($base['body']['databases'][0]['$id'], $databases['body']['databases'][0]['$id']);
+
+ $databases = $this->client->call(Client::METHOD_GET, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::cursorBefore(new Document(['$id' => $base['body']['databases'][0]['$id']]))->toString(),
+ ],
+ ]);
+
+ $this->assertCount(0, $databases['body']['databases']);
+ $this->assertEmpty($databases['body']['databases']);
+
+ /**
+ * Test for Search
+ */
+ $databases = $this->client->call(Client::METHOD_GET, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'search' => 'first'
+ ]);
+
+ $this->assertEquals(1, $databases['body']['total']);
+ $this->assertEquals('first', $databases['body']['databases'][0]['$id']);
+
+ $databases = $this->client->call(Client::METHOD_GET, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'search' => 'Test'
+ ]);
+
+ $this->assertEquals(2, $databases['body']['total']);
+ $this->assertEquals('Test 1', $databases['body']['databases'][0]['name']);
+ $this->assertEquals('Test 2', $databases['body']['databases'][1]['name']);
+
+ $databases = $this->client->call(Client::METHOD_GET, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'search' => 'Nonexistent'
+ ]);
+
+ $this->assertEquals(0, $databases['body']['total']);
+
+ /**
+ * Test for FAILURE
+ */
+ $response = $this->client->call(Client::METHOD_GET, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::cursorAfter(new Document(['$id' => 'unknown']))->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(400, $response['headers']['status-code']);
+
+ // This database already exists
+ $response = $this->client->call(Client::METHOD_POST, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'name' => 'Test 1',
+ 'databaseId' => ID::custom('first'),
+ ]);
+
+ $this->assertEquals(409, $response['headers']['status-code']);
+ return ['databaseId' => $test1['body']['$id']];
+ }
+
+ /**
+ * @depends testListDatabases
+ */
+ public function testGetDatabase(array $data): array
+ {
+ $databaseId = $data['databaseId'];
+ /**
+ * Test for SUCCESS
+ */
+ $database = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId, [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]);
+
+ $this->assertEquals(200, $database['headers']['status-code']);
+ $this->assertEquals($databaseId, $database['body']['$id']);
+ $this->assertEquals('Test 1', $database['body']['name']);
+ $this->assertEquals(true, $database['body']['enabled']);
+ return ['databaseId' => $database['body']['$id']];
+ }
+
+ /**
+ * @depends testListDatabases
+ */
+ public function testUpdateDatabase(array $data)
+ {
+ $databaseId = $data['databaseId'];
+
+ $database = $this->client->call(Client::METHOD_PUT, '/databases/' . $databaseId, [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], [
+ 'name' => 'Test 1 Updated',
+ 'enabled' => false,
+ ]);
+
+ $this->assertEquals(200, $database['headers']['status-code']);
+ $this->assertEquals('Test 1 Updated', $database['body']['name']);
+ $this->assertFalse($database['body']['enabled']);
+
+ // Now update the database without the passing the enabled parameter
+ $database = $this->client->call(Client::METHOD_PUT, '/databases/' . $databaseId, [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], [
+ 'name' => 'Test 1'
+ ]);
+
+ $this->assertEquals(200, $database['headers']['status-code']);
+ $this->assertEquals('Test 1', $database['body']['name']);
+ $this->assertTrue($database['body']['enabled']);
+ }
+
+ /**
+ * @depends testListDatabases
+ */
+ public function testDeleteDatabase($data)
+ {
+ $databaseId = $data['databaseId'];
+
+ $response = $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], $this->getHeaders()));
+
+ $this->assertEquals(204, $response['headers']['status-code']);
+ $this->assertEquals("", $response['body']);
+
+ // Try to get the database and check if it has been deleted
+ $response = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id']
+ ], $this->getHeaders()));
+
+ $this->assertEquals(404, $response['headers']['status-code']);
+ }
+
+ public function testListTables(): array
+ {
+ $database = $this->client->call(Client::METHOD_POST, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'databaseId' => ID::unique(),
+ 'name' => 'invalidRowDatabase',
+ ]);
+ $this->assertEquals(201, $database['headers']['status-code']);
+ $this->assertEquals('invalidRowDatabase', $database['body']['name']);
+ $this->assertTrue($database['body']['enabled']);
+
+ $databaseId = $database['body']['$id'];
+ /**
+ * Test for SUCCESS
+ */
+ $test1 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'name' => 'Test 1',
+ 'tableId' => ID::custom('first'),
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::create(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ 'rowSecurity' => true,
+ ]);
+
+ $test2 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'name' => 'Test 2',
+ 'tableId' => ID::custom('second'),
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::create(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ 'rowSecurity' => true,
+ ]);
+
+ $tables = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(2, $tables['body']['total']);
+ $this->assertEquals($test1['body']['$id'], $tables['body']['tables'][0]['$id']);
+ $this->assertEquals($test1['body']['enabled'], $tables['body']['tables'][0]['enabled']);
+ $this->assertEquals($test2['body']['$id'], $tables['body']['tables'][1]['$id']);
+ $this->assertEquals($test1['body']['enabled'], $tables['body']['tables'][0]['enabled']);
+
+ $base = array_reverse($tables['body']['tables']);
+
+ $tables = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::limit(1)->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $tables['headers']['status-code']);
+ $this->assertCount(1, $tables['body']['tables']);
+
+ $tables = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::offset(1)->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $tables['headers']['status-code']);
+ $this->assertCount(1, $tables['body']['tables']);
+
+ $tables = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::equal('enabled', [true])->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $tables['headers']['status-code']);
+ $this->assertCount(2, $tables['body']['tables']);
+
+ $tables = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::equal('enabled', [false])->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $tables['headers']['status-code']);
+ $this->assertCount(0, $tables['body']['tables']);
+
+ /**
+ * Test for Order
+ */
+ $tables = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::orderDesc()->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(2, $tables['body']['total']);
+ $this->assertEquals($base[0]['$id'], $tables['body']['tables'][0]['$id']);
+ $this->assertEquals($base[1]['$id'], $tables['body']['tables'][1]['$id']);
+
+ /**
+ * Test for After
+ */
+ $base = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $tables = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::cursorAfter(new Document(['$id' => $base['body']['tables'][0]['$id']]))->toString(),
+ ],
+ ]);
+
+ $this->assertCount(1, $tables['body']['tables']);
+ $this->assertEquals($base['body']['tables'][1]['$id'], $tables['body']['tables'][0]['$id']);
+
+ $tables = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::cursorAfter(new Document(['$id' => $base['body']['tables'][1]['$id']]))->toString(),
+ ],
+ ]);
+
+ $this->assertCount(0, $tables['body']['tables']);
+ $this->assertEmpty($tables['body']['tables']);
+
+ /**
+ * Test for Before
+ */
+ $base = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $tables = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::cursorBefore(new Document(['$id' => $base['body']['tables'][1]['$id']]))->toString(),
+ ],
+ ]);
+
+ $this->assertCount(1, $tables['body']['tables']);
+ $this->assertEquals($base['body']['tables'][0]['$id'], $tables['body']['tables'][0]['$id']);
+
+ $tables = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::cursorBefore(new Document(['$id' => $base['body']['tables'][0]['$id']]))->toString(),
+ ],
+ ]);
+
+ $this->assertCount(0, $tables['body']['tables']);
+ $this->assertEmpty($tables['body']['tables']);
+
+ /**
+ * Test for Search
+ */
+ $tables = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'search' => 'first'
+ ]);
+
+ $this->assertEquals(1, $tables['body']['total']);
+ $this->assertEquals('first', $tables['body']['tables'][0]['$id']);
+
+ $tables = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'search' => 'Test'
+ ]);
+
+ $this->assertEquals(2, $tables['body']['total']);
+ $this->assertEquals('Test 1', $tables['body']['tables'][0]['name']);
+ $this->assertEquals('Test 2', $tables['body']['tables'][1]['name']);
+
+ $tables = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'search' => 'Nonexistent'
+ ]);
+
+ $this->assertEquals(0, $tables['body']['total']);
+
+ /**
+ * Test for FAILURE
+ */
+ $response = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::cursorAfter(new Document(['$id' => 'unknown']))->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(400, $response['headers']['status-code']);
+
+ // This table already exists
+ $response = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'name' => 'Test 1',
+ 'tableId' => ID::custom('first'),
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::create(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ 'rowSecurity' => true,
+ ]);
+
+ $this->assertEquals(409, $response['headers']['status-code']);
+ return [
+ 'databaseId' => $databaseId,
+ 'tableId' => $test1['body']['$id'],
+ ];
+ }
+
+ /**
+ * @depends testListTables
+ */
+ public function testGetTable(array $data): void
+ {
+ $databaseId = $data['databaseId'];
+ $tableId = $data['tableId'];
+
+ $table = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $table['headers']['status-code']);
+ $this->assertEquals('Test 1', $table['body']['name']);
+ $this->assertEquals('first', $table['body']['$id']);
+ $this->assertTrue($table['body']['enabled']);
+ }
+
+ /**
+ * @depends testListTables
+ */
+ public function testUpdateTable(array $data)
+ {
+ $databaseId = $data['databaseId'];
+ $tableId = $data['tableId'];
+
+ $table = $this->client->call(Client::METHOD_PUT, '/databases/' . $databaseId . '/tables/' . $tableId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'name' => 'Test 1 Updated',
+ 'enabled' => false
+ ]);
+
+ $this->assertEquals(200, $table['headers']['status-code']);
+ $this->assertEquals('Test 1 Updated', $table['body']['name']);
+ $this->assertEquals('first', $table['body']['$id']);
+ $this->assertFalse($table['body']['enabled']);
+ }
+
+ /**
+ * @depends testListTables
+ */
+ public function testCreateEncryptedColumn(array $data): void
+ {
+
+ $databaseId = $data['databaseId'];
+
+ /**
+ * Test for SUCCESS
+ */
+
+ // Create table
+ $actors = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Encrypted Actors Data',
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::create(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ 'rowSecurity' => true,
+ ]);
+
+ $this->assertEquals(201, $actors['headers']['status-code']);
+ $this->assertEquals('Encrypted Actors Data', $actors['body']['name']);
+
+ /**
+ * Test for creating encrypted columns
+ */
+
+ $columnsPath = '/databases/' . $databaseId . '/tables/' . $actors['body']['$id'] . '/columns';
+
+ $firstName = $this->client->call(Client::METHOD_POST, $columnsPath . '/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'firstName',
+ 'size' => 256,
+ 'required' => true,
+ ]);
+
+ $lastName = $this->client->call(Client::METHOD_POST, $columnsPath . '/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'lastName',
+ 'size' => 256,
+ 'required' => true,
+ 'encrypt' => true,
+ ]);
+
+
+ /**
+ * Check status of every column
+ */
+ $this->assertEquals(202, $firstName['headers']['status-code']);
+ $this->assertEquals('firstName', $firstName['body']['key']);
+ $this->assertEquals('string', $firstName['body']['type']);
+
+ $this->assertEquals(202, $lastName['headers']['status-code']);
+ $this->assertEquals('lastName', $lastName['body']['key']);
+ $this->assertEquals('string', $lastName['body']['type']);
+
+ // Wait for database worker to finish creating columns
+ sleep(2);
+
+ // Creating row to ensure cache is purged on schema change
+ $row = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $actors['body']['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'firstName' => 'Jonah',
+ 'lastName' => 'Jameson',
+ ],
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ ]);
+
+ // Check row to ensure cache is purged on schema change
+ $row = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $actors['body']['$id'] . '/rows/' . $row['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals(200, $row['headers']['status-code']);
+ $this->assertEquals('Jonah', $row['body']['firstName']);
+ $this->assertEquals('Jameson', $row['body']['lastName']);
+ }
+
+ public function testDeleteColumn(): array
+ {
+ $database = $this->client->call(Client::METHOD_POST, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'databaseId' => ID::unique(),
+ 'name' => 'invalidRowDatabase',
+ ]);
+ $this->assertEquals(201, $database['headers']['status-code']);
+ $this->assertEquals('invalidRowDatabase', $database['body']['name']);
+
+ $databaseId = $database['body']['$id'];
+ /**
+ * Test for SUCCESS
+ */
+
+ // Create table
+ $actors = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Actors',
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::create(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ 'rowSecurity' => true,
+ ]);
+
+ $this->assertEquals(201, $actors['headers']['status-code']);
+ $this->assertEquals($actors['body']['name'], 'Actors');
+
+ $firstName = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $actors['body']['$id'] . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'firstName',
+ 'size' => 256,
+ 'required' => true,
+ ]);
+
+ $lastName = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $actors['body']['$id'] . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'lastName',
+ 'size' => 256,
+ 'required' => true,
+ ]);
+
+ $unneeded = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $actors['body']['$id'] . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'unneeded',
+ 'size' => 256,
+ 'required' => true,
+ ]);
+
+ // Wait for database worker to finish creating columns
+ sleep(2);
+
+ // Creating row to ensure cache is purged on schema change
+ $row = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $actors['body']['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'firstName' => 'lorem',
+ 'lastName' => 'ipsum',
+ 'unneeded' => 'dolor'
+ ],
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ ]);
+
+ $index = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $actors['body']['$id'] . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'key_lastName',
+ 'type' => 'key',
+ 'columns' => [
+ 'lastName',
+ ],
+ ]);
+
+ // Wait for database worker to finish creating index
+ sleep(2);
+
+ $table = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $actors['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), []);
+
+ $unneededId = $unneeded['body']['key'];
+
+ $this->assertEquals(200, $table['headers']['status-code']);
+ $this->assertIsArray($table['body']['columns']);
+ $this->assertCount(3, $table['body']['columns']);
+ $this->assertEquals($table['body']['columns'][0]['key'], $firstName['body']['key']);
+ $this->assertEquals($table['body']['columns'][1]['key'], $lastName['body']['key']);
+ $this->assertEquals($table['body']['columns'][2]['key'], $unneeded['body']['key']);
+ $this->assertCount(1, $table['body']['indexes']);
+ $this->assertEquals($table['body']['indexes'][0]['key'], $index['body']['key']);
+
+ // Delete column
+ $column = $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $actors['body']['$id'] . '/columns/' . $unneededId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals(204, $column['headers']['status-code']);
+
+ sleep(2);
+
+ // Check row to ensure cache is purged on schema change
+ $row = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $actors['body']['$id'] . '/rows/' . $row['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertNotContains($unneededId, $row['body']);
+
+ $table = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $actors['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), []);
+
+ $this->assertEquals(200, $table['headers']['status-code']);
+ $this->assertIsArray($table['body']['columns']);
+ $this->assertCount(2, $table['body']['columns']);
+ $this->assertEquals($table['body']['columns'][0]['key'], $firstName['body']['key']);
+ $this->assertEquals($table['body']['columns'][1]['key'], $lastName['body']['key']);
+
+ return [
+ 'tableId' => $actors['body']['$id'],
+ 'key' => $index['body']['key'],
+ 'databaseId' => $databaseId
+ ];
+ }
+
+ /**
+ * @depends testDeleteColumn
+ */
+ public function testDeleteIndex($data): array
+ {
+ $databaseId = $data['databaseId'];
+ $index = $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $data['tableId'] . '/indexes/' . $data['key'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals(204, $index['headers']['status-code']);
+
+ // Wait for database worker to finish deleting index
+ sleep(2);
+
+ $table = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['tableId'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), []);
+
+ $this->assertCount(0, $table['body']['indexes']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testDeleteIndex
+ */
+ public function testDeleteIndexOnDeleteColumn($data)
+ {
+ $databaseId = $data['databaseId'];
+ $column1 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['tableId'] . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'column1',
+ 'size' => 16,
+ 'required' => true,
+ ]);
+
+ $column2 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['tableId'] . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'column2',
+ 'size' => 16,
+ 'required' => true,
+ ]);
+
+ $this->assertEquals(202, $column1['headers']['status-code']);
+ $this->assertEquals(202, $column2['headers']['status-code']);
+ $this->assertEquals('column1', $column1['body']['key']);
+ $this->assertEquals('column2', $column2['body']['key']);
+
+ sleep(2);
+
+ $index1 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['tableId'] . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'index1',
+ 'type' => 'key',
+ 'columns' => ['column1', 'column2'],
+ 'orders' => ['ASC', 'ASC'],
+ ]);
+
+ $index2 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['tableId'] . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'index2',
+ 'type' => 'key',
+ 'columns' => ['column2'],
+ ]);
+
+ $this->assertEquals(202, $index1['headers']['status-code']);
+ $this->assertEquals(202, $index2['headers']['status-code']);
+ $this->assertEquals('index1', $index1['body']['key']);
+ $this->assertEquals('index2', $index2['body']['key']);
+
+ sleep(2);
+
+ // Expected behavior: deleting column2 will cause index2 to be dropped, and index1 rebuilt with a single key
+ $deleted = $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $data['tableId'] . '/columns/' . $column2['body']['key'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals(204, $deleted['headers']['status-code']);
+
+ // wait for database worker to complete
+ sleep(2);
+
+ $table = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $data['tableId'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals(200, $table['headers']['status-code']);
+ $this->assertIsArray($table['body']['indexes']);
+ $this->assertCount(1, $table['body']['indexes']);
+ $this->assertEquals($index1['body']['key'], $table['body']['indexes'][0]['key']);
+ $this->assertIsArray($table['body']['indexes'][0]['columns']);
+ $this->assertCount(1, $table['body']['indexes'][0]['columns']);
+ $this->assertEquals($column1['body']['key'], $table['body']['indexes'][0]['columns'][0]);
+
+ // Delete column
+ $deleted = $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $data['tableId'] . '/columns/' . $column1['body']['key'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals(204, $deleted['headers']['status-code']);
+
+ return $data;
+ }
+
+ public function testCleanupDuplicateIndexOnDeleteColumn()
+ {
+ $database = $this->client->call(Client::METHOD_POST, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'databaseId' => ID::unique(),
+ 'name' => 'invalidRowDatabase',
+ ]);
+ $this->assertEquals(201, $database['headers']['status-code']);
+ $this->assertEquals('invalidRowDatabase', $database['body']['name']);
+
+ $databaseId = $database['body']['$id'];
+ $table = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'TestCleanupDuplicateIndexOnDeleteColumn',
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::create(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ 'rowSecurity' => true,
+ ]);
+
+ $this->assertEquals(201, $table['headers']['status-code']);
+ $this->assertNotEmpty($table['body']['$id']);
+
+ $tableId = $table['body']['$id'];
+
+ $column1 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'column1',
+ 'size' => 16,
+ 'required' => true,
+ ]);
+
+ $column2 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'column2',
+ 'size' => 16,
+ 'required' => true,
+ ]);
+
+ $this->assertEquals(202, $column1['headers']['status-code']);
+ $this->assertEquals(202, $column2['headers']['status-code']);
+ $this->assertEquals('column1', $column1['body']['key']);
+ $this->assertEquals('column2', $column2['body']['key']);
+
+ sleep(2);
+
+ $index1 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'index1',
+ 'type' => 'key',
+ 'columns' => ['column1', 'column2'],
+ 'orders' => ['ASC', 'ASC'],
+ ]);
+
+ $index2 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'index2',
+ 'type' => 'key',
+ 'columns' => ['column2'],
+ ]);
+
+ $this->assertEquals(202, $index1['headers']['status-code']);
+ $this->assertEquals(202, $index2['headers']['status-code']);
+ $this->assertEquals('index1', $index1['body']['key']);
+ $this->assertEquals('index2', $index2['body']['key']);
+
+ sleep(2);
+
+ // Expected behavior: deleting column1 would cause index1 to be a duplicate of index2 and automatically removed
+ $deleted = $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $column1['body']['key'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals(204, $deleted['headers']['status-code']);
+
+ // wait for database worker to complete
+ sleep(2);
+
+ $table = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals(200, $table['headers']['status-code']);
+ $this->assertIsArray($table['body']['indexes']);
+ $this->assertCount(1, $table['body']['indexes']);
+ $this->assertEquals($index2['body']['key'], $table['body']['indexes'][0]['key']);
+ $this->assertIsArray($table['body']['indexes'][0]['columns']);
+ $this->assertCount(1, $table['body']['indexes'][0]['columns']);
+ $this->assertEquals($column2['body']['key'], $table['body']['indexes'][0]['columns'][0]);
+
+ // Delete column
+ $deleted = $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $column2['body']['key'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals(204, $deleted['headers']['status-code']);
+ }
+
+ /**
+ * @depends testDeleteIndexOnDeleteColumn
+ */
+ public function testDeleteTable($data)
+ {
+ $databaseId = $data['databaseId'];
+ $tableId = $data['tableId'];
+
+ // Add Rows to the table
+ $row1 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'firstName' => 'Tom',
+ 'lastName' => 'Holland',
+ ],
+ 'permissions' => [
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::delete(Role::user($this->getUser()['$id'])),
+ ],
+ ]);
+
+ $row2 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'firstName' => 'Samuel',
+ 'lastName' => 'Jackson',
+ ],
+ 'permissions' => [
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::delete(Role::user($this->getUser()['$id'])),
+ ],
+ ]);
+
+ $this->assertEquals(201, $row1['headers']['status-code']);
+ $this->assertIsArray($row1['body']['$permissions']);
+ $this->assertCount(3, $row1['body']['$permissions']);
+ $this->assertEquals($row1['body']['firstName'], 'Tom');
+ $this->assertEquals($row1['body']['lastName'], 'Holland');
+
+ $this->assertEquals(201, $row2['headers']['status-code']);
+ $this->assertIsArray($row2['body']['$permissions']);
+ $this->assertCount(3, $row2['body']['$permissions']);
+ $this->assertEquals('Samuel', $row2['body']['firstName']);
+ $this->assertEquals('Jackson', $row2['body']['lastName']);
+
+ // Delete the actors table
+ $response = $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $tableId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], $this->getHeaders()));
+
+ $this->assertEquals(204, $response['headers']['status-code']);
+ $this->assertEquals($response['body'], "");
+
+ // Try to get the table and check if it has been deleted
+ $response = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id']
+ ], $this->getHeaders()));
+
+ $this->assertEquals(404, $response['headers']['status-code']);
+ }
+
+ /**
+ * @throws Exception
+ */
+ public function testDeleteTableDeletesRelatedColumns(): void
+ {
+ $database = $this->client->call(Client::METHOD_POST, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'databaseId' => ID::unique(),
+ 'name' => 'TestDeleteTableDeletesRelatedColumns',
+ ]);
+
+ $databaseId = $database['body']['$id'];
+
+ $table1 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Table1',
+ 'rowSecurity' => false,
+ 'permissions' => [],
+ ]);
+
+ $table2 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Table2',
+ 'rowSecurity' => false,
+ 'permissions' => [],
+ ]);
+
+ $table1 = $table1['body']['$id'];
+ $table2 = $table2['body']['$id'];
+
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table1 . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ]), [
+ 'relatedTableId' => $table2,
+ 'type' => Database::RELATION_MANY_TO_ONE,
+ 'twoWay' => false,
+ 'key' => 'table2'
+ ]);
+
+ sleep(2);
+
+ $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $table2, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ], $this->getHeaders()));
+
+ sleep(2);
+
+ $columns = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $table1 . '/columns', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(0, $columns['body']['total']);
+ }
+
+ public function testColumnRowWidthLimit()
+ {
+ $database = $this->client->call(Client::METHOD_POST, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'databaseId' => ID::unique(),
+ 'name' => 'invalidRowDatabase',
+ ]);
+ $this->assertEquals(201, $database['headers']['status-code']);
+ $this->assertEquals('invalidRowDatabase', $database['body']['name']);
+
+ $databaseId = $database['body']['$id'];
+ $table = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::custom('columnRowWidthLimit'),
+ 'name' => 'columnRowWidthLimit',
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::create(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ 'rowSecurity' => true,
+ ]);
+
+ $this->assertEquals(201, $table['headers']['status-code']);
+ $this->assertEquals('columnRowWidthLimit', $table['body']['name']);
+
+ $tableId = $table['body']['$id'];
+
+ // Add wide string columns to approach row width limit
+ for ($i = 0; $i < 15; $i++) {
+ $column = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => "column{$i}",
+ 'size' => 1024,
+ 'required' => true,
+ ]);
+
+ $this->assertEquals(202, $column['headers']['status-code']);
+ }
+
+ sleep(5);
+
+ $tooWide = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'tooWide',
+ 'size' => 1024,
+ 'required' => true,
+ ]);
+
+ $this->assertEquals(400, $tooWide['headers']['status-code']);
+ $this->assertEquals('column_limit_exceeded', $tooWide['body']['type']);
+ }
+
+ public function testIndexLimitException()
+ {
+ $database = $this->client->call(Client::METHOD_POST, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'databaseId' => ID::unique(),
+ 'name' => 'invalidRowDatabase',
+ ]);
+ $this->assertEquals(201, $database['headers']['status-code']);
+ $this->assertEquals('invalidRowDatabase', $database['body']['name']);
+
+ $databaseId = $database['body']['$id'];
+ $table = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::custom('testLimitException'),
+ 'name' => 'testLimitException',
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::create(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ 'rowSecurity' => true,
+ ]);
+
+ $this->assertEquals(201, $table['headers']['status-code']);
+ $this->assertEquals('testLimitException', $table['body']['name']);
+
+ $tableId = $table['body']['$id'];
+
+ // add unique columns for indexing
+ for ($i = 0; $i < 64; $i++) {
+ // $this->assertEquals(true, static::getDatabase()->createColumn('indexLimit', "test{$i}", Database::VAR_STRING, 16, true));
+ $column = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => "column{$i}",
+ 'size' => 64,
+ 'required' => true,
+ ]);
+
+ $this->assertEquals(202, $column['headers']['status-code']);
+ }
+
+ sleep(10);
+
+ $table = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals(200, $table['headers']['status-code']);
+ $this->assertEquals('testLimitException', $table['body']['name']);
+ $this->assertIsArray($table['body']['columns']);
+ $this->assertIsArray($table['body']['indexes']);
+ $this->assertCount(64, $table['body']['columns']);
+ $this->assertCount(0, $table['body']['indexes']);
+
+ foreach ($table['body']['columns'] as $column) {
+ $this->assertEquals('available', $column['status'], 'column: ' . $column['key']);
+ }
+
+ // Test indexLimit = 64
+ // MariaDB, MySQL, and MongoDB create 6 indexes per new table
+ // Add up to the limit, then check if the next index throws IndexLimitException
+ for ($i = 0; $i < 58; $i++) {
+ $index = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => "key_column{$i}",
+ 'type' => 'key',
+ 'columns' => ["column{$i}"],
+ ]);
+
+ $this->assertEquals(202, $index['headers']['status-code']);
+ $this->assertEquals("key_column{$i}", $index['body']['key']);
+ }
+
+ sleep(5);
+
+ $table = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals(200, $table['headers']['status-code']);
+ $this->assertEquals($table['body']['name'], 'testLimitException');
+ $this->assertIsArray($table['body']['columns']);
+ $this->assertIsArray($table['body']['indexes']);
+ $this->assertCount(64, $table['body']['columns']);
+ $this->assertCount(58, $table['body']['indexes']);
+
+ $tooMany = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'tooMany',
+ 'type' => 'key',
+ 'columns' => ['column61'],
+ ]);
+
+ $this->assertEquals(400, $tooMany['headers']['status-code']);
+ $this->assertEquals('Index limit exceeded', $tooMany['body']['message']);
+
+ $table = $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $tableId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals(204, $table['headers']['status-code']);
+ }
+
+ public function testColumnUpdate(): array
+ {
+ $database = $this->client->call(Client::METHOD_POST, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'databaseId' => ID::unique(),
+ 'name' => 'updateColumns',
+ ]);
+ $this->assertEquals(201, $database['headers']['status-code']);
+
+ $databaseId = $database['body']['$id'];
+ $table = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::custom('updateColumns'),
+ 'name' => 'updateColumns'
+ ]);
+
+ $this->assertEquals(201, $table['headers']['status-code']);
+
+ $tableId = $table['body']['$id'];
+
+ /**
+ * Create String Column
+ */
+ $column = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'string',
+ 'size' => 1024,
+ 'required' => false
+ ]);
+
+ $this->assertEquals(202, $column['headers']['status-code']);
+
+ /**
+ * Create Email Column
+ */
+ $column = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/email', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'email',
+ 'required' => false
+ ]);
+
+ $this->assertEquals(202, $column['headers']['status-code']);
+
+ /**
+ * Create IP Column
+ */
+ $column = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/ip', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'ip',
+ 'required' => false
+ ]);
+
+ $this->assertEquals(202, $column['headers']['status-code']);
+
+ /**
+ * Create URL Column
+ */
+ $column = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/url', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'url',
+ 'required' => false
+ ]);
+
+ $this->assertEquals(202, $column['headers']['status-code']);
+
+ /**
+ * Create Integer Column
+ */
+ $column = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/integer', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'integer',
+ 'required' => false
+ ]);
+
+ $this->assertEquals(202, $column['headers']['status-code']);
+
+ /**
+ * Create Float Column
+ */
+ $column = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/float', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'float',
+ 'required' => false
+ ]);
+
+ /**
+ * Create Boolean Column
+ */
+ $column = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/boolean', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'boolean',
+ 'required' => false
+ ]);
+
+ /**
+ * Create Datetime Column
+ */
+ $column = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/datetime', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'datetime',
+ 'required' => false
+ ]);
+
+ /**
+ * Create Enum Column
+ */
+ $column = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/enum', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'enum',
+ 'required' => false,
+ 'elements' => ['lorem', 'ipsum']
+ ]);
+
+ $this->assertEquals(202, $column['headers']['status-code']);
+
+ sleep(5);
+
+ return [
+ 'databaseId' => $databaseId,
+ 'tableId' => $tableId
+ ];
+ }
+
+ /**
+ * @depends testColumnUpdate
+ */
+ public function testColumnUpdateString(array $data)
+ {
+ $key = 'string';
+ $databaseId = $data['databaseId'];
+ $tableId = $data['tableId'];
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/string/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 'lorem'
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertEquals('lorem', $new['body']['default']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $column = array_values(array_filter($new['body']['columns'], fn (array $a) => $a['key'] === $key))[0] ?? null;
+ $this->assertNotNull($column);
+ $this->assertFalse($column['required']);
+ $this->assertEquals('lorem', $column['default']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/string/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => null
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertNull($new['body']['default']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/string/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 'ipsum'
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertEquals('ipsum', $new['body']['default']);
+
+ /**
+ * Test against failure
+ */
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/string/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => 'i am no boolean',
+ 'default' => 'dolor'
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/string/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 123
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/string/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => true,
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/string/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'default' => 'ipsum'
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/string/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => true,
+ 'default' => 'ipsum'
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::COLUMN_DEFAULT_UNSUPPORTED, $update['body']['type']);
+ }
+
+ /**
+ * @depends testColumnUpdate
+ */
+ public function testColumnUpdateEmail(array $data)
+ {
+ $key = 'email';
+ $databaseId = $data['databaseId'];
+ $tableId = $data['tableId'];
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/email/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 'torsten@appwrite.io'
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertEquals('torsten@appwrite.io', $new['body']['default']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $column = array_values(array_filter($new['body']['columns'], fn (array $a) => $a['key'] === $key))[0] ?? null;
+ $this->assertNotNull($column);
+ $this->assertFalse($column['required']);
+ $this->assertEquals('torsten@appwrite.io', $column['default']);
+
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/email/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => null
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertNull($new['body']['default']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/email/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 'eldad@appwrite.io'
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertEquals('eldad@appwrite.io', $new['body']['default']);
+
+ /**
+ * Test against failure
+ */
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/email/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => 'no boolean',
+ 'default' => 'torsten@appwrite.io'
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/email/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 'i am no email'
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/email/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => true,
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/email/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'default' => 'ipsum'
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/email/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => true,
+ 'default' => 'torsten@appwrite.io'
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::COLUMN_DEFAULT_UNSUPPORTED, $update['body']['type']);
+ }
+
+ /**
+ * @depends testColumnUpdate
+ */
+ public function testColumnUpdateIp(array $data)
+ {
+ $key = 'ip';
+ $databaseId = $data['databaseId'];
+ $tableId = $data['tableId'];
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/ip/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => '127.0.0.1'
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertEquals('127.0.0.1', $new['body']['default']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $column = array_values(array_filter($new['body']['columns'], fn (array $a) => $a['key'] === $key))[0] ?? null;
+ $this->assertNotNull($column);
+ $this->assertFalse($column['required']);
+ $this->assertEquals('127.0.0.1', $column['default']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/ip/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => null
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertNull($new['body']['default']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/ip/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => '192.168.0.1'
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertEquals('192.168.0.1', $new['body']['default']);
+
+ /**
+ * Test against failure
+ */
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/ip/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => 'no boolean',
+ 'default' => '127.0.0.1'
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/ip/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 'i am no ip'
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/ip/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => true,
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/ip/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'default' => '127.0.0.1'
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/ip/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => true,
+ 'default' => '127.0.0.1'
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::COLUMN_DEFAULT_UNSUPPORTED, $update['body']['type']);
+ }
+
+ /**
+ * @depends testColumnUpdate
+ */
+ public function testColumnUpdateUrl(array $data)
+ {
+ $key = 'url';
+ $databaseId = $data['databaseId'];
+ $tableId = $data['tableId'];
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/url/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 'http://appwrite.io'
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertEquals('http://appwrite.io', $new['body']['default']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $column = array_values(array_filter($new['body']['columns'], fn (array $a) => $a['key'] === $key))[0] ?? null;
+ $this->assertNotNull($column);
+ $this->assertFalse($column['required']);
+ $this->assertEquals('http://appwrite.io', $column['default']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/url/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => null
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertNull($new['body']['default']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/url/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 'https://appwrite.io'
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertEquals('https://appwrite.io', $new['body']['default']);
+
+ /**
+ * Test against failure
+ */
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/url/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => 'no boolean',
+ 'default' => 'https://appwrite.io'
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/url/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 'i am no url'
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/url/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => true,
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/url/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'default' => 'https://appwrite.io'
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/url/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => true,
+ 'default' => 'https://appwrite.io'
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::COLUMN_DEFAULT_UNSUPPORTED, $update['body']['type']);
+ }
+
+ /**
+ * @depends testColumnUpdate
+ */
+ public function testColumnUpdateInteger(array $data)
+ {
+ $key = 'integer';
+ $databaseId = $data['databaseId'];
+ $tableId = $data['tableId'];
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/integer/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 123,
+ 'min' => 0,
+ 'max' => 1000
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertEquals(123, $new['body']['default']);
+ $this->assertEquals(0, $new['body']['min']);
+ $this->assertEquals(1000, $new['body']['max']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $column = array_values(array_filter($new['body']['columns'], fn (array $a) => $a['key'] === $key))[0] ?? null;
+ $this->assertNotNull($column);
+ $this->assertFalse($column['required']);
+ $this->assertEquals(123, $column['default']);
+ $this->assertEquals(0, $column['min']);
+ $this->assertEquals(1000, $column['max']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/integer/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => null,
+ 'min' => 0,
+ 'max' => 1000
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertNull($new['body']['default']);
+ $this->assertEquals(0, $new['body']['min']);
+ $this->assertEquals(1000, $new['body']['max']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/integer/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 456,
+ 'min' => 100,
+ 'max' => 2000
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertEquals(456, $new['body']['default']);
+ $this->assertEquals(100, $new['body']['min']);
+ $this->assertEquals(2000, $new['body']['max']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/integer/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 100,
+ 'min' => 0,
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/integer/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 10,
+ 'max' => 100,
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ /**
+ * Test against failure
+ */
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/integer/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => 'no boolean',
+ 'default' => 123,
+ 'min' => 0,
+ 'max' => 500
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/integer/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 'i am no integer',
+ 'min' => 0,
+ 'max' => 500
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/integer/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 100,
+ 'min' => 'i am no integer',
+ 'max' => 500
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/integer/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 100,
+ 'min' => 0,
+ 'max' => 'i am no integer'
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/integer/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'min' => 0,
+ 'max' => 100,
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/integer/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'default' => 50,
+ 'min' => 0,
+ 'max' => 100,
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/integer/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => true,
+ 'default' => 50,
+ 'min' => 0,
+ 'max' => 100
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::COLUMN_DEFAULT_UNSUPPORTED, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/integer/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 50,
+ 'min' => 55,
+ 'max' => 100
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::COLUMN_VALUE_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/integer/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 105,
+ 'min' => 50,
+ 'max' => 100
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::COLUMN_VALUE_INVALID, $update['body']['type']);
+
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/integer/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 50,
+ 'min' => 200,
+ 'max' => 100
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::COLUMN_VALUE_INVALID, $update['body']['type']);
+ }
+
+ /**
+ * @depends testColumnUpdate
+ */
+ public function testColumnUpdateFloat(array $data)
+ {
+ $key = 'float';
+ $databaseId = $data['databaseId'];
+ $tableId = $data['tableId'];
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/float/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 123.456,
+ 'min' => 0.0,
+ 'max' => 1000.0
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertEquals(123.456, $new['body']['default']);
+ $this->assertEquals(0, $new['body']['min']);
+ $this->assertEquals(1000, $new['body']['max']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $column = array_values(array_filter($new['body']['columns'], fn (array $a) => $a['key'] === $key))[0] ?? null;
+ $this->assertNotNull($column);
+ $this->assertFalse($column['required']);
+ $this->assertEquals(123.456, $column['default']);
+ $this->assertEquals(0, $column['min']);
+ $this->assertEquals(1000, $column['max']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/float/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => null,
+ 'min' => 0.0,
+ 'max' => 1000.0
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertNull($new['body']['default']);
+ $this->assertEquals(0, $new['body']['min']);
+ $this->assertEquals(1000, $new['body']['max']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/float/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 456.789,
+ 'min' => 123.456,
+ 'max' => 2000.0
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertEquals(456.789, $new['body']['default']);
+ $this->assertEquals(123.456, $new['body']['min']);
+ $this->assertEquals(2000, $new['body']['max']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/float/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 123.456,
+ 'min' => 0.0,
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/float/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 23.456,
+ 'max' => 100.0,
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ /**
+ * Test against failure
+ */
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/float/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => 'no boolean',
+ 'default' => 123.456,
+ 'min' => 0.0,
+ 'max' => 1000.0
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/float/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 'i am no integer',
+ 'min' => 0.0,
+ 'max' => 500.0
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/float/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 123.456,
+ 'min' => 'i am no integer',
+ 'max' => 500.0
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/float/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 123.456,
+ 'min' => 0.0,
+ 'max' => 'i am no integer'
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/float/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'min' => 0.0,
+ 'max' => 100.0,
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/float/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'default' => 123.456,
+ 'min' => 0.0,
+ 'max' => 100.0,
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/float/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => true,
+ 'default' => 123.456,
+ 'min' => 0.0,
+ 'max' => 100.0
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::COLUMN_DEFAULT_UNSUPPORTED, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/float/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 123.456,
+ 'min' => 200.0,
+ 'max' => 300.0
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::COLUMN_VALUE_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/float/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 123.456,
+ 'min' => 0.0,
+ 'max' => 100.0
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::COLUMN_VALUE_INVALID, $update['body']['type']);
+
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/float/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 50.0,
+ 'min' => 200.0,
+ 'max' => 100.0
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::COLUMN_VALUE_INVALID, $update['body']['type']);
+ }
+
+ /**
+ * @depends testColumnUpdate
+ */
+ public function testColumnUpdateBoolean(array $data)
+ {
+ $key = 'boolean';
+ $databaseId = $data['databaseId'];
+ $tableId = $data['tableId'];
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/boolean/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => true
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertEquals(true, $new['body']['default']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $column = array_values(array_filter($new['body']['columns'], fn (array $a) => $a['key'] === $key))[0] ?? null;
+ $this->assertNotNull($column);
+ $this->assertFalse($column['required']);
+ $this->assertEquals(true, $column['default']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/boolean/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => null
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertNull($new['body']['default']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/boolean/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => false
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertEquals(false, $new['body']['default']);
+
+ /**
+ * Test against failure
+ */
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/boolean/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => 'no boolean',
+ 'default' => true
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/boolean/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 'i am no boolean'
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/boolean/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => true,
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/boolean/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'default' => false
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/boolean/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => true,
+ 'default' => true
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::COLUMN_DEFAULT_UNSUPPORTED, $update['body']['type']);
+ }
+
+ /**
+ * @depends testColumnUpdate
+ */
+ public function testColumnUpdateDatetime(array $data)
+ {
+ $key = 'datetime';
+ $databaseId = $data['databaseId'];
+ $tableId = $data['tableId'];
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/datetime/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => '1975-06-12 14:12:55+02:00'
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertEquals('1975-06-12 14:12:55+02:00', $new['body']['default']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $column = array_values(array_filter($new['body']['columns'], fn (array $a) => $a['key'] === $key))[0] ?? null;
+ $this->assertNotNull($column);
+ $this->assertFalse($column['required']);
+ $this->assertEquals('1975-06-12 14:12:55+02:00', $column['default']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/datetime/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => null
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertNull($new['body']['default']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/datetime/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => '1965-06-12 14:12:55+02:00'
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertEquals('1965-06-12 14:12:55+02:00', $new['body']['default']);
+
+ /**
+ * Test against failure
+ */
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/datetime/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => 'no boolean',
+ 'default' => '1975-06-12 14:12:55+02:00'
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/datetime/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 'i am no datetime'
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/datetime/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => true,
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/datetime/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'default' => '1975-06-12 14:12:55+02:00'
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/datetime/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => true,
+ 'default' => '1975-06-12 14:12:55+02:00'
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::COLUMN_DEFAULT_UNSUPPORTED, $update['body']['type']);
+ }
+
+ /**
+ * @depends testColumnUpdate
+ */
+ public function testColumnUpdateEnum(array $data)
+ {
+ $key = 'enum';
+ $databaseId = $data['databaseId'];
+ $tableId = $data['tableId'];
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/enum/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'elements' => ['lorem', 'ipsum', 'dolor'],
+ 'required' => false,
+ 'default' => 'lorem'
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertEquals('lorem', $new['body']['default']);
+ $this->assertCount(3, $new['body']['elements']);
+ $this->assertContains('lorem', $new['body']['elements']);
+ $this->assertContains('ipsum', $new['body']['elements']);
+ $this->assertContains('dolor', $new['body']['elements']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $column = array_values(array_filter($new['body']['columns'], fn (array $a) => $a['key'] === $key))[0] ?? null;
+ $this->assertNotNull($column);
+ $this->assertFalse($column['required']);
+ $this->assertEquals('lorem', $column['default']);
+ $this->assertCount(3, $column['elements']);
+ $this->assertContains('lorem', $column['elements']);
+ $this->assertContains('ipsum', $column['elements']);
+ $this->assertContains('dolor', $column['elements']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/enum/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'elements' => ['lorem', 'ipsum', 'dolor'],
+ 'required' => false,
+ 'default' => null
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertNull($new['body']['default']);
+ $this->assertCount(3, $new['body']['elements']);
+ $this->assertContains('lorem', $new['body']['elements']);
+ $this->assertContains('ipsum', $new['body']['elements']);
+ $this->assertContains('dolor', $new['body']['elements']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/enum/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'elements' => ['ipsum', 'dolor'],
+ 'required' => false,
+ 'default' => 'dolor'
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertFalse($new['body']['required']);
+ $this->assertEquals('dolor', $new['body']['default']);
+ $this->assertCount(2, $new['body']['elements']);
+ $this->assertContains('ipsum', $new['body']['elements']);
+ $this->assertContains('dolor', $new['body']['elements']);
+
+ /**
+ * Test against failure
+ */
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/enum/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'elements' => [],
+ 'required' => false,
+ 'default' => 'lorem'
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::COLUMN_VALUE_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/enum/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'elements' => ['ipsum', 'dolor'],
+ 'required' => false,
+ 'default' => 'lorem'
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::COLUMN_VALUE_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/enum/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => 'no boolean',
+ 'default' => 'lorem',
+ 'elements' => ['lorem', 'ipsum', 'dolor'],
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/enum/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 123,
+ 'elements' => ['lorem', 'ipsum', 'dolor'],
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/enum/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 'lorem',
+ 'elements' => 'i am no array',
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/enum/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 'lorem',
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/enum/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => true,
+ 'elements' => ['lorem', 'ipsum', 'dolor'],
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/enum/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'default' => 'lorem',
+ 'elements' => ['lorem', 'ipsum', 'dolor'],
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::GENERAL_ARGUMENT_INVALID, $update['body']['type']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/enum/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => true,
+ 'default' => 'lorem',
+ 'elements' => ['lorem', 'ipsum', 'dolor'],
+ ]);
+
+ $this->assertEquals(400, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::COLUMN_DEFAULT_UNSUPPORTED, $update['body']['type']);
+ }
+
+ /**
+ * @depends testColumnUpdate
+ */
+ public function testColumnUpdateStringResize(array $data)
+ {
+ $key = 'string';
+ $databaseId = $data['databaseId'];
+ $tableId = $data['tableId'];
+
+ $row = $this->client->call(
+ Client::METHOD_POST,
+ '/databases/' . $databaseId . '/tables/' . $tableId . '/rows',
+ array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]),
+ [
+ 'rowId' => 'unique()',
+ 'data' => [
+ 'string' => 'string'
+ ],
+ "permissions" => ["read(\"any\")"]
+ ]
+ );
+
+ // Test Resize Up
+ $column = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/string/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'size' => 2048,
+ 'default' => '',
+ 'required' => false
+ ]);
+
+ $this->assertEquals(200, $column['headers']['status-code']);
+ $this->assertEquals(2048, $column['body']['size']);
+
+ // Test create new row with new size
+ $newDoc = $this->client->call(
+ Client::METHOD_POST,
+ '/databases/' . $databaseId . '/tables/' . $tableId . '/rows',
+ array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]),
+ [
+ 'rowId' => 'unique()',
+ 'data' => [
+ 'string' => str_repeat('a', 2048)
+ ],
+ "permissions" => ["read(\"any\")"]
+ ]
+ );
+
+ $this->assertEquals(201, $newDoc['headers']['status-code']);
+ $this->assertEquals(2048, strlen($newDoc['body']['string']));
+
+ // Test update row with new size
+ $row = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows/' . $row['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'data' => [
+ 'string' => str_repeat('a', 2048)
+ ]
+ ]);
+
+ $this->assertEquals(200, $row['headers']['status-code']);
+ $this->assertEquals(2048, strlen($row['body']['string']));
+
+ // Test Exception on resize down with data that is too large
+ $column = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/string/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'size' => 10,
+ 'default' => '',
+ 'required' => false
+ ]);
+
+ $this->assertEquals(400, $column['headers']['status-code']);
+ $this->assertEquals(AppwriteException::COLUMN_INVALID_RESIZE, $column['body']['type']);
+
+ // original rows to original size, remove new row
+ $row = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows/' . $row['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'data' => [
+ 'string' => 'string'
+ ]
+ ]);
+
+ $this->assertEquals(200, $row['headers']['status-code']);
+ $this->assertEquals('string', $row['body']['string']);
+
+ $deleteDoc = $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows/' . $newDoc['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals(204, $deleteDoc['headers']['status-code']);
+
+
+ // Test Resize Down
+ $column = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/string/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'size' => 10,
+ 'default' => '',
+ 'required' => false
+ ]);
+
+ $this->assertEquals(200, $column['headers']['status-code']);
+ $this->assertEquals(10, $column['body']['size']);
+
+ // Test create new row with new size
+ $newDoc = $this->client->call(
+ Client::METHOD_POST,
+ '/databases/' . $databaseId . '/tables/' . $tableId . '/rows',
+ array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]),
+ [
+ 'rowId' => 'unique()',
+ 'data' => [
+ 'string' => str_repeat('a', 10)
+ ],
+ "permissions" => ["read(\"any\")"]
+ ]
+ );
+
+ $this->assertEquals(201, $newDoc['headers']['status-code']);
+ $this->assertEquals(10, strlen($newDoc['body']['string']));
+
+ // Test update row with new size
+ $row = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows/' . $row['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'data' => [
+ 'string' => str_repeat('a', 10)
+ ]
+ ]);
+
+ $this->assertEquals(200, $row['headers']['status-code']);
+ $this->assertEquals(10, strlen($row['body']['string']));
+
+ // Try create row with string that is too large
+ $newDoc = $this->client->call(
+ Client::METHOD_POST,
+ '/databases/' . $databaseId . '/tables/' . $tableId . '/rows',
+ array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]),
+ [
+ 'rowId' => 'unique()',
+ 'data' => [
+ 'string' => str_repeat('a', 11)
+ ],
+ "permissions" => ["read(\"any\")"]
+ ]
+ );
+
+ $this->assertEquals(400, $newDoc['headers']['status-code']);
+ $this->assertEquals(AppwriteException::ROW_INVALID_STRUCTURE, $newDoc['body']['type']);
+ }
+
+ /**
+ * @depends testColumnUpdate
+ */
+ public function testColumnUpdateNotFound(array $data)
+ {
+ $databaseId = $data['databaseId'];
+ $tableId = $data['tableId'];
+
+ $columns = [
+ 'string' => [
+ 'required' => false,
+ 'default' => 'ipsum'
+ ],
+ 'email' => [
+ 'required' => false,
+ 'default' => 'eldad@appwrite.io'
+ ],
+ 'ip' => [
+ 'required' => false,
+ 'default' => '127.0.0.1'
+ ],
+ 'url' => [
+ 'required' => false,
+ 'default' => 'https://appwrite.io'
+ ],
+ 'integer' => [
+ 'required' => false,
+ 'default' => 5,
+ 'min' => 0,
+ 'max' => 10
+ ],
+ 'float' => [
+ 'required' => false,
+ 'default' => 5.5,
+ 'min' => 0.0,
+ 'max' => 10.0
+ ],
+ 'datetime' => [
+ 'required' => false,
+ 'default' => '1975-06-12 14:12:55+02:00'
+ ],
+ 'enum' => [
+ 'elements' => ['lorem', 'ipsum', 'dolor'],
+ 'required' => false,
+ 'default' => 'lorem'
+ ]
+ ];
+
+ foreach ($columns as $key => $payload) {
+ /**
+ * Check if Database exists
+ */
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/i_dont_exist/tables/' . $tableId . '/columns/' . $key . '/unknown_' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), $payload);
+
+ $this->assertEquals(404, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::DATABASE_NOT_FOUND, $update['body']['type']);
+
+ /**
+ * Check if Table exists
+ */
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/i_dont_exist/columns/' . $key . '/unknown_' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), $payload);
+
+ $this->assertEquals(404, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::TABLE_NOT_FOUND, $update['body']['type']);
+
+ /**
+ * Check if Column exists
+ */
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key . '/unknown_' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), $payload);
+
+ $this->assertEquals(404, $update['headers']['status-code']);
+ $this->assertEquals(AppwriteException::COLUMN_NOT_FOUND, $update['body']['type']);
+ }
+ }
+
+ /**
+ * @depends testColumnUpdate
+ */
+ public function testColumnRename(array $data)
+ {
+ $key = 'string';
+ $databaseId = $data['databaseId'];
+ $tableId = $data['tableId'];
+
+ // Create row to test against
+ $row = $this->client->call(
+ Client::METHOD_POST,
+ '/databases/' . $databaseId . '/tables/' . $tableId . '/rows',
+ array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]),
+ [
+ 'rowId' => 'unique()',
+ 'data' => [
+ 'string' => 'string'
+ ],
+ "permissions" => ["read(\"any\")"]
+ ]
+ );
+
+ $this->assertEquals(201, $row['headers']['status-code']);
+
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/string/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'required' => false,
+ 'default' => 'lorum',
+ 'newKey' => 'new_string',
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ $key = 'new_string';
+
+ $new = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/columns/' . $key, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals('new_string', $new['body']['key']);
+
+ $doc1 = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tableId . '/rows/' . $row['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertArrayHasKey('new_string', $doc1['body']);
+ $this->assertEquals('string', $doc1['body']['new_string']);
+ $this->assertArrayNotHasKey('string', $doc1['body']);
+
+ // Try and create a new row with the new column
+ $doc2 = $this->client->call(
+ Client::METHOD_POST,
+ '/databases/' . $databaseId . '/tables/' . $tableId . '/rows',
+ array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]),
+ [
+ 'rowId' => 'unique()',
+ 'data' => [
+ 'new_string' => 'string'
+ ],
+ "permissions" => ["read(\"any\")"]
+ ]
+ );
+
+ $this->assertEquals(201, $doc2['headers']['status-code']);
+ $this->assertArrayHasKey('new_string', $doc2['body']);
+ $this->assertEquals('string', $doc2['body']['new_string']);
+
+ // Expect fail, try and create a new row with the old column
+ $doc3 = $this->client->call(
+ Client::METHOD_POST,
+ '/databases/' . $databaseId . '/tables/' . $tableId . '/rows',
+ array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]),
+ [
+ 'rowId' => 'unique()',
+ 'data' => [
+ 'string' => 'string'
+ ],
+ "permissions" => ["read(\"any\")"]
+ ]
+ );
+
+ $this->assertEquals(400, $doc3['headers']['status-code']);
+ }
+
+ public function createRelationshipTables(): void
+ {
+ // Prepare the database with tables and relationships
+ $database = $this->client->call(Client::METHOD_POST, '/databases', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], [
+ 'databaseId' => 'database1',
+ 'name' => 'Test Database'
+ ]);
+
+ $databaseId = $database['body']['$id'];
+
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => 'table1',
+ 'name' => 'level1',
+ 'rowSecurity' => false,
+ 'permissions' => [
+ Permission::create(Role::user($this->getUser()['$id'])),
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::delete(Role::user($this->getUser()['$id'])),
+ ]
+ ]);
+
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => 'table2',
+ 'name' => 'level2',
+ 'rowSecurity' => false,
+ 'permissions' => [
+ Permission::create(Role::user($this->getUser()['$id'])),
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::delete(Role::user($this->getUser()['$id'])),
+ ]
+ ]);
+
+ \sleep(2);
+ }
+
+ public function cleanupRelationshipTable(): void
+ {
+ $this->client->call(Client::METHOD_DELETE, '/databases/database1', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]);
+
+ \sleep(2);
+ }
+
+ public function testColumnRenameRelationshipOneToMany()
+ {
+ $databaseId = 'database1';
+ $table1Id = 'table1';
+ $table2Id = 'table2';
+
+ $this->createRelationshipTables();
+
+ $relation = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table1Id . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'relatedTableId' => $table2Id,
+ 'type' => 'oneToMany',
+ 'twoWay' => true,
+ 'onDelete' => 'cascade',
+ 'key' => 'level2',
+ 'twoWayKey' => 'level1'
+ ]);
+
+ \sleep(3);
+
+ $table1Columns = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $table1Id, [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]);
+
+ $table1RelationColumn = $table1Columns['body']['columns'][0];
+
+ $this->assertEquals($relation['body']['side'], $table1RelationColumn['side']);
+ $this->assertEquals($relation['body']['twoWayKey'], $table1RelationColumn['twoWayKey']);
+ $this->assertEquals($relation['body']['relatedTable'], $table1RelationColumn['relatedTable']);
+
+ // Create a row for checking later
+ $originalRow = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table1Id . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'rowId' => 'unique()',
+ 'data' => [
+ 'level2' => [[
+ '$id' => 'unique()',
+ '$permissions' => ["read(\"any\")"]
+ ]],
+ ],
+ "permissions" => ["read(\"any\")"]
+ ]);
+
+ $this->assertEquals(201, $originalRow['headers']['status-code']);
+
+ // Rename the column
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $table1Id . '/columns/level2' . '/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'newKey' => 'new_level_2'
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ // Check the row's key has been renamed
+ $newRow = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $table1Id . '/rows/' . $originalRow['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertArrayHasKey('new_level_2', $newRow['body']);
+ $this->assertEquals(1, count($newRow['body']['new_level_2']));
+ $this->assertArrayNotHasKey('level2', $newRow['body']);
+
+ // Check level2 row has been renamed
+ $level2Row = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $table2Id . '/rows/' . $newRow['body']['new_level_2'][0]['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertArrayHasKey('level1', $level2Row['body']);
+ $this->assertNotEmpty($level2Row['body']['level1']);
+
+ // Check if column was renamed on the parent's side
+ $table1Columns = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $table1Id, [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]);
+
+ $this->assertEquals(200, $table1Columns['headers']['status-code']);
+ $this->assertEquals(1, count($table1Columns['body']['columns']));
+ $this->assertEquals('new_level_2', $table1Columns['body']['columns'][0]['key']);
+
+ // Check if column was renamed on the child's side
+ $table2Columns = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $table2Id, [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]);
+
+ $this->assertEquals(200, $table2Columns['headers']['status-code']);
+ $this->assertEquals(1, count($table2Columns['body']['columns']));
+ $this->assertEquals('new_level_2', $table2Columns['body']['columns'][0]['twoWayKey']);
+
+ $this->cleanupRelationshipTable();
+ }
+
+ public function testColumnRenameRelationshipOneToOne()
+ {
+ $databaseId = 'database1';
+ $table1Id = 'table1';
+ $table2Id = 'table2';
+
+ $this->createRelationshipTables();
+
+ $relation = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table1Id . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'relatedTableId' => $table2Id,
+ 'type' => 'oneToOne',
+ 'twoWay' => true,
+ 'onDelete' => 'cascade',
+ 'key' => 'level2',
+ 'twoWayKey' => 'level1'
+ ]);
+
+ \sleep(3);
+
+ $table1Columns = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $table1Id, [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]);
+
+ $table1RelationColumn = $table1Columns['body']['columns'][0];
+
+ $this->assertEquals($relation['body']['side'], $table1RelationColumn['side']);
+ $this->assertEquals($relation['body']['twoWayKey'], $table1RelationColumn['twoWayKey']);
+ $this->assertEquals($relation['body']['relatedTable'], $table1RelationColumn['relatedTable']);
+
+ // Create a row for checking later
+ $originalRow = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table1Id . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'rowId' => 'unique()',
+ 'data' => [
+ 'level2' => [
+ '$id' => 'unique()',
+ '$permissions' => ["read(\"any\")"]
+ ],
+ ],
+ "permissions" => ["read(\"any\")"]
+ ]);
+
+ $this->assertEquals(201, $originalRow['headers']['status-code']);
+
+ // Rename the column
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $table1Id . '/columns/level2' . '/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'newKey' => 'new_level_2'
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ // Check the row's key has been renamed
+ $newRow = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $table1Id . '/rows/' . $originalRow['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertArrayHasKey('new_level_2', $newRow['body']);
+ $this->assertNotEmpty($newRow['body']['new_level_2']);
+ $this->assertArrayNotHasKey('level2', $newRow['body']);
+
+ // Check level2 row has been renamed
+ $level2Row = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $table2Id . '/rows/' . $newRow['body']['new_level_2']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertArrayHasKey('level1', $level2Row['body']);
+ $this->assertNotEmpty($level2Row['body']['level1']);
+
+ // Check if column was renamed on the parent's side
+ $table1Columns = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $table1Id, [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]);
+
+ $this->assertEquals(200, $table1Columns['headers']['status-code']);
+ $this->assertEquals(1, count($table1Columns['body']['columns']));
+ $this->assertEquals('new_level_2', $table1Columns['body']['columns'][0]['key']);
+
+ // Check if column was renamed on the child's side
+ $table2Columns = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $table2Id, [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]);
+
+ $this->assertEquals(200, $table2Columns['headers']['status-code']);
+ $this->assertEquals(1, count($table2Columns['body']['columns']));
+ $this->assertEquals('new_level_2', $table2Columns['body']['columns'][0]['twoWayKey']);
+
+ $this->cleanupRelationshipTable();
+ }
+
+ public function testColumnRenameRelationshipManyToOne()
+ {
+ $databaseId = 'database1';
+ $table1Id = 'table1';
+ $table2Id = 'table2';
+
+ $this->createRelationshipTables();
+
+ $relation = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table1Id . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'relatedTableId' => $table2Id,
+ 'type' => 'manyToOne',
+ 'twoWay' => true,
+ 'onDelete' => 'cascade',
+ 'key' => 'level2',
+ 'twoWayKey' => 'level1'
+ ]);
+
+ \sleep(3);
+
+ $table1Columns = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $table1Id, [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]);
+
+ $table1RelationColumn = $table1Columns['body']['columns'][0];
+
+ $this->assertEquals($relation['body']['side'], $table1RelationColumn['side']);
+ $this->assertEquals($relation['body']['twoWayKey'], $table1RelationColumn['twoWayKey']);
+ $this->assertEquals($relation['body']['relatedTable'], $table1RelationColumn['relatedTable']);
+
+ // Create a row for checking later
+ $originalRow = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table1Id . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'rowId' => 'unique()',
+ 'data' => [
+ 'level2' => [
+ '$id' => 'unique()',
+ '$permissions' => ["read(\"any\")"]
+ ],
+ ],
+ "permissions" => ["read(\"any\")"]
+ ]);
+
+ $this->assertEquals(201, $originalRow['headers']['status-code']);
+
+ // Rename the column
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $table1Id . '/columns/level2' . '/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'newKey' => 'new_level_2'
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ // Check the row's key has been renamed
+ $newRow = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $table1Id . '/rows/' . $originalRow['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertArrayHasKey('new_level_2', $newRow['body']);
+ $this->assertNotEmpty($newRow['body']['new_level_2']);
+ $this->assertArrayNotHasKey('level2', $newRow['body']);
+
+ // Check level2 row has been renamed
+ $level2Row = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $table2Id . '/rows/' . $newRow['body']['new_level_2']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertArrayHasKey('level1', $level2Row['body']);
+ $this->assertNotEmpty($level2Row['body']['level1']);
+
+ // Check if column was renamed on the parent's side
+ $table1Columns = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $table1Id, [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]);
+
+ $this->assertEquals(200, $table1Columns['headers']['status-code']);
+ $this->assertEquals(1, count($table1Columns['body']['columns']));
+ $this->assertEquals('new_level_2', $table1Columns['body']['columns'][0]['key']);
+
+ // Check if column was renamed on the child's side
+ $table2Columns = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $table2Id, [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]);
+
+ $this->assertEquals(200, $table2Columns['headers']['status-code']);
+ $this->assertEquals(1, count($table2Columns['body']['columns']));
+ $this->assertEquals('new_level_2', $table2Columns['body']['columns'][0]['twoWayKey']);
+
+ $this->cleanupRelationshipTable();
+ }
+
+ public function testColumnRenameRelationshipManyToMany()
+ {
+ $databaseId = 'database1';
+ $table1Id = 'table1';
+ $table2Id = 'table2';
+
+ $this->createRelationshipTables();
+
+ $relation = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table1Id . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'relatedTableId' => $table2Id,
+ 'type' => 'manyToOne',
+ 'twoWay' => true,
+ 'onDelete' => 'cascade',
+ 'key' => 'level2',
+ 'twoWayKey' => 'level1'
+ ]);
+
+ \sleep(3);
+
+ $table1Columns = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $table1Id, [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]);
+
+ $table1RelationColumn = $table1Columns['body']['columns'][0];
+
+ $this->assertEquals($relation['body']['side'], $table1RelationColumn['side']);
+ $this->assertEquals($relation['body']['twoWayKey'], $table1RelationColumn['twoWayKey']);
+ $this->assertEquals($relation['body']['relatedTable'], $table1RelationColumn['relatedTable']);
+
+ // Create a row for checking later
+ $originalRow = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $table1Id . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'rowId' => 'unique()',
+ 'data' => [
+ 'level2' => [
+ '$id' => 'unique()',
+ '$permissions' => ["read(\"any\")"]
+ ],
+ ],
+ "permissions" => ["read(\"any\")"]
+ ]);
+
+ $this->assertEquals(201, $originalRow['headers']['status-code']);
+
+ // Rename the column
+ $update = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $table1Id . '/columns/level2' . '/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'newKey' => 'new_level_2'
+ ]);
+
+ $this->assertEquals(200, $update['headers']['status-code']);
+
+ // Check the row's key has been renamed
+ $newRow = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $table1Id . '/rows/' . $originalRow['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertArrayHasKey('new_level_2', $newRow['body']);
+ $this->assertNotEmpty($newRow['body']['new_level_2']);
+ $this->assertArrayNotHasKey('level2', $newRow['body']);
+
+ // Check level2 row has been renamed
+ $level2Row = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $table2Id . '/rows/' . $newRow['body']['new_level_2']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertArrayHasKey('level1', $level2Row['body']);
+ $this->assertNotEmpty($level2Row['body']['level1']);
+
+ // Check if column was renamed on the parent's side
+ $table1Columns = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $table1Id, [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]);
+
+ $this->assertEquals(200, $table1Columns['headers']['status-code']);
+ $this->assertEquals(1, count($table1Columns['body']['columns']));
+ $this->assertEquals('new_level_2', $table1Columns['body']['columns'][0]['key']);
+
+ // Check if column was renamed on the child's side
+ $table2Columns = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $table2Id, [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]);
+
+ $this->assertEquals(200, $table2Columns['headers']['status-code']);
+ $this->assertEquals(1, count($table2Columns['body']['columns']));
+ $this->assertEquals('new_level_2', $table2Columns['body']['columns'][0]['twoWayKey']);
+
+ $this->cleanupRelationshipTable();
+ }
+
+ public function testBulkCreate(): void
+ {
+ // Create database
+ $database = $this->client->call(Client::METHOD_POST, '/databases', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], [
+ 'databaseId' => ID::unique(),
+ 'name' => 'Bulk Create Perms',
+ ]);
+
+ $this->assertNotEmpty($database['body']['$id']);
+
+ $databaseId = $database['body']['$id'];
+
+ $table = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Bulk Create Perms',
+ 'rowSecurity' => true,
+ 'permissions' => [
+ Permission::create(Role::any()),
+ Permission::read(Role::any()),
+ Permission::delete(Role::any()),
+ Permission::update(Role::any()),
+ ],
+ ]);
+
+ $this->assertEquals(201, $table['headers']['status-code']);
+
+ $data = [
+ '$id' => $table['body']['$id'],
+ 'databaseId' => $table['body']['databaseId']
+ ];
+
+ // Await column
+ $numberColumn = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['$id'] . '/columns/integer', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'number',
+ 'required' => true,
+ ]);
+
+ $this->assertEquals(202, $numberColumn['headers']['status-code']);
+
+ sleep(1);
+
+ $response = $this->client->call(Client::METHOD_POST, "/databases/{$databaseId}/tables/{$data['$id']}/rows", array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rows' => [
+ [
+ '$id' => ID::unique(),
+ 'number' => 1,
+ ],
+ [
+ '$id' => ID::unique(),
+ 'number' => 2,
+ ],
+ [
+ '$id' => ID::unique(),
+ 'number' => 3,
+ ],
+ ],
+ ]);
+
+ $this->assertEquals(201, $response['headers']['status-code']);
+ $this->assertCount(3, $response['body']['rows']);
+
+ $response = $this->client->call(Client::METHOD_GET, "/databases/{$databaseId}/tables/{$data['$id']}/rows", array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(1, $response['body']['rows'][0]['number']);
+ $this->assertEquals(2, $response['body']['rows'][1]['number']);
+ $this->assertEquals(3, $response['body']['rows'][2]['number']);
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertCount(3, $response['body']['rows']);
+
+ // TEST SUCCESS - $id is auto-assigned if not included in bulk rows
+ $response = $this->client->call(Client::METHOD_POST, "/databases/{$databaseId}/tables/{$data['$id']}/rows", array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rows' => [
+ [
+ 'number' => 1,
+ ]
+ ],
+ ]);
+
+ $this->assertEquals(201, $response['headers']['status-code']);
+
+ // TEST FAIL - Can't use data and row together
+ $response = $this->client->call(Client::METHOD_POST, "/databases/{$databaseId}/tables/{$data['$id']}/rows", array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'number' => 5
+ ],
+ 'rows' => [
+ [
+ '$id' => ID::unique(),
+ 'number' => 1,
+ ]
+ ],
+ ]);
+
+ $this->assertEquals(400, $response['headers']['status-code']);
+
+ // TEST FAIL - Can't use $rowId and create bulk rows
+ $response = $this->client->call(Client::METHOD_POST, "/databases/{$databaseId}/tables/{$data['$id']}/rows", array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'rows' => [
+ [
+ '$id' => ID::unique(),
+ 'number' => 1,
+ ]
+ ],
+ ]);
+
+ $this->assertEquals(400, $response['headers']['status-code']);
+
+ // TEST FAIL - Can't include invalid ID in bulk rows
+ $response = $this->client->call(Client::METHOD_POST, "/databases/{$databaseId}/tables/{$data['$id']}/rows", array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rows' => [
+ [
+ '$id' => '$invalid',
+ 'number' => 1,
+ ]
+ ],
+ ]);
+
+ $this->assertEquals(400, $response['headers']['status-code']);
+
+ // TEST FAIL - Can't miss number in bulk rows
+ $response = $this->client->call(Client::METHOD_POST, "/databases/{$databaseId}/tables/{$data['$id']}/rows", array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rows' => [
+ [
+ '$id' => ID::unique(),
+ 'number' => 1,
+ ],
+ [
+ '$id' => ID::unique(),
+ ],
+ ],
+ ]);
+
+ $this->assertEquals(400, $response['headers']['status-code']);
+
+ // TEST FAIL - Can't push more than APP_LIMIT_DATABASE_BATCH rows
+ $response = $this->client->call(Client::METHOD_POST, "/databases/{$databaseId}/tables/{$data['$id']}/rows", array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rows' => array_fill(0, APP_LIMIT_DATABASE_BATCH + 1, [
+ '$id' => ID::unique(),
+ 'number' => 1,
+ ]),
+ ]);
+
+ $this->assertEquals(400, $response['headers']['status-code']);
+
+ // TEST FAIL - Can't include invalid permissions in nested rows
+ $response = $this->client->call(Client::METHOD_POST, "/databases/{$databaseId}/tables/{$data['$id']}/rows", array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rows' => [
+ [
+ '$id' => ID::unique(),
+ '$permissions' => ['invalid'],
+ 'number' => 1,
+ ],
+ ],
+ ]);
+
+ // TEST FAIL - Can't bulk create in a table with relationships
+ $table2 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Bulk Related',
+ 'rowSecurity' => true,
+ 'permissions' => [],
+ ]);
+
+ $response = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['$id'] . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], $this->getHeaders()), [
+ 'relatedTableId' => $table2['body']['$id'],
+ 'type' => 'manyToOne',
+ 'twoWay' => true,
+ 'onDelete' => 'cascade',
+ 'key' => 'level2',
+ 'twoWayKey' => 'level1'
+ ]);
+
+ $this->assertEquals(202, $response['headers']['status-code']);
+
+ sleep(1);
+
+ $response = $this->client->call(Client::METHOD_POST, "/databases/{$databaseId}/tables/{$data['$id']}/rows", array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rows' => [
+ ['$id' => ID::unique(), 'number' => 1,],
+ ['$id' => ID::unique(), 'number' => 2,],
+ ],
+ ]);
+
+ $this->assertEquals(400, $response['headers']['status-code']);
+ }
+
+ public function testBulkUpdate(): void
+ {
+ // Create database
+ $database = $this->client->call(Client::METHOD_POST, '/databases', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], [
+ 'databaseId' => ID::unique(),
+ 'name' => 'Bulk Updates'
+ ]);
+
+ $this->assertNotEmpty($database['body']['$id']);
+
+ $databaseId = $database['body']['$id'];
+
+ $table = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Bulk Updates',
+ 'rowSecurity' => true,
+ 'permissions' => [
+ Permission::create(Role::any()),
+ Permission::read(Role::any()),
+ Permission::delete(Role::any()),
+ Permission::update(Role::any()),
+ ],
+ ]);
+
+ $this->assertEquals(201, $table['headers']['status-code']);
+
+ $data = [
+ '$id' => $table['body']['$id'],
+ 'databaseId' => $table['body']['databaseId']
+ ];
+
+ // Await column
+ $numberColumn = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['$id'] . '/columns/integer', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'number',
+ 'required' => true,
+ ]);
+
+ $this->assertEquals(202, $numberColumn['headers']['status-code']);
+
+ // Wait for database worker to create columns
+ sleep(2);
+
+ // Create rows
+ $createBulkRows = function ($amount = 10) use ($data) {
+ $rows = [];
+
+ for ($x = 1; $x <= $amount; $x++) {
+ $rows[] = [
+ '$id' => ID::unique(),
+ 'number' => $x,
+ ];
+ }
+
+ $doc = $this->client->call(Client::METHOD_POST, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rows' => $rows,
+ ]);
+
+ $this->assertEquals(201, $doc['headers']['status-code']);
+ };
+
+ $createBulkRows();
+
+ // TEST: Update all rows
+ $response = $this->client->call(Client::METHOD_PATCH, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'number' => 100,
+ '$permissions' => [
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::delete(Role::user($this->getUser()['$id'])),
+ ]
+ ],
+ ]);
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertCount(10, $response['body']['rows']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ Query::equal('number', [100])->toString(),
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(10, $rows['body']['total']);
+
+ $returnedRows = $response['body']['rows'];
+ $refetchedRows = $rows['body']['rows'];
+
+ $this->assertEquals($returnedRows, $refetchedRows);
+
+ foreach ($rows['body']['rows'] as $row) {
+ $this->assertEquals([
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::delete(Role::user($this->getUser()['$id'])),
+ ], $row['$permissions']);
+ $this->assertEquals($table['body']['$id'], $row['$tableId']);
+ $this->assertEquals($data['databaseId'], $row['$databaseId']);
+ $this->assertEquals(100, $row['number']);
+ }
+
+ // TEST: Check permissions persist
+ $response = $this->client->call(Client::METHOD_PATCH, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'number' => 200
+ ],
+ ]);
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertCount(10, $response['body']['rows']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ Query::equal('number', [200])->toString(),
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(10, $rows['body']['total']);
+
+ foreach ($rows['body']['rows'] as $row) {
+ $this->assertEquals([
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::delete(Role::user($this->getUser()['$id'])),
+ ], $row['$permissions']);
+ }
+
+ // TEST: Update rows with limit
+ $response = $this->client->call(Client::METHOD_PATCH, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'number' => 300
+ ],
+ 'queries' => [
+ Query::limit(5)->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertCount(5, $response['body']['rows']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [Query::equal('number', [200])->toString()]
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(5, $rows['body']['total']);
+
+ // TEST: Update rows with offset
+ $response = $this->client->call(Client::METHOD_PATCH, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'number' => 300
+ ],
+ 'queries' => [
+ Query::offset(5)->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertCount(5, $response['body']['rows']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [Query::equal('number', [300])->toString()]
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(10, $rows['body']['total']);
+
+ // TEST: Update rows with equals filter
+ $response = $this->client->call(Client::METHOD_PATCH, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'number' => 400
+ ],
+ 'queries' => [
+ Query::equal('number', [300])->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertCount(10, $response['body']['rows']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [Query::equal('number', [400])->toString()]
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(10, $rows['body']['total']);
+
+ // TEST: Fail - Can't bulk update in a table with relationships
+ $table2 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Bulk Related',
+ 'rowSecurity' => true,
+ 'permissions' => [],
+ ]);
+
+ $response = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['$id'] . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], $this->getHeaders()), [
+ 'relatedTableId' => $table2['body']['$id'],
+ 'type' => 'manyToOne',
+ 'twoWay' => true,
+ 'onDelete' => 'cascade',
+ 'key' => 'level2',
+ 'twoWayKey' => 'level1'
+ ]);
+
+ $this->assertEquals(202, $response['headers']['status-code']);
+
+ sleep(1);
+
+ $response = $this->client->call(Client::METHOD_PATCH, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'number' => 500
+ ],
+ 'queries' => [
+ Query::equal('number', [300])->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(400, $response['headers']['status-code']);
+ }
+
+ public function testBulkUpsert(): void
+ {
+ // Create database
+ $database = $this->client->call(Client::METHOD_POST, '/databases', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], [
+ 'databaseId' => ID::unique(),
+ 'name' => 'Bulk Upserts'
+ ]);
+
+ $this->assertNotEmpty($database['body']['$id']);
+
+ $databaseId = $database['body']['$id'];
+
+ $table = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Bulk Upserts',
+ 'rowSecurity' => true,
+ 'permissions' => [
+ Permission::create(Role::any()),
+ Permission::read(Role::any()),
+ Permission::delete(Role::any()),
+ Permission::update(Role::any()),
+ ],
+ ]);
+
+ $this->assertEquals(201, $table['headers']['status-code']);
+
+ $data = [
+ '$id' => $table['body']['$id'],
+ 'databaseId' => $table['body']['databaseId']
+ ];
+
+ // Await column
+ $numberColumn = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['$id'] . '/columns/integer', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'number',
+ 'required' => true,
+ ]);
+
+ $this->assertEquals(202, $numberColumn['headers']['status-code']);
+
+ // Wait for database worker to create columns
+ sleep(2);
+
+ // Create rows
+ $createBulkRows = function ($amount = 10) use ($data) {
+ $rows = [];
+
+ for ($x = 1; $x <= $amount; $x++) {
+ $rows[] = [
+ '$id' => "$x",
+ 'number' => $x,
+ ];
+ }
+
+ $response = $this->client->call(Client::METHOD_POST, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rows' => $rows,
+ ]);
+
+ $this->assertEquals(201, $response['headers']['status-code']);
+
+ return $rows;
+ };
+
+ $rows = $createBulkRows();
+
+ // Update 1 row
+ $rows[\array_key_last($rows)]['number'] = 1000;
+
+ // Add 1 row
+ $rows[] = ['number' => 11];
+
+ // TEST: Upsert all rows
+ $response = $this->client->call(Client::METHOD_PUT, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rows' => $rows,
+ ]);
+
+ // Unchanged docs are skipped. 2 rows should be returned, 1 updated and 1 inserted.
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertCount(2, $response['body']['rows']);
+ $this->assertEquals(1000, $response['body']['rows'][0]['number']);
+ $this->assertEquals(11, $response['body']['rows'][1]['number']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ]));
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(11, $rows['body']['total']);
+
+ foreach ($rows['body']['rows'] as $index => $row) {
+ $this->assertEquals($table['body']['$id'], $row['$tableId']);
+ $this->assertEquals($data['databaseId'], $row['$databaseId']);
+ switch ($index) {
+ case 9:
+ $this->assertEquals(1000, $row['number']);
+ break;
+ default:
+ $this->assertEquals($index + 1, $row['number']);
+ }
+ }
+
+ // TEST: Upsert permissions
+ $response = $this->client->call(Client::METHOD_PUT, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rows' => [
+ [
+ '$id' => '1',
+ 'number' => 1000,
+ ],
+ [
+ '$id' => '10',
+ '$permissions' => [
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::delete(Role::user($this->getUser()['$id'])),
+ ],
+ 'number' => 10,
+ ],
+ ],
+ ]);
+
+ $this->assertEquals(1000, $response['body']['rows'][0]['number']);
+ $this->assertEquals([], $response['body']['rows'][0]['$permissions']);
+ $this->assertEquals([
+ Permission::read(Role::user($this->getUser()['$id'])),
+ Permission::update(Role::user($this->getUser()['$id'])),
+ Permission::delete(Role::user($this->getUser()['$id'])),
+ ], $response['body']['rows'][1]['$permissions']);
+
+ // TEST: Fail - Can't bulk upsert in a table with relationships
+ $table2 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Bulk Related',
+ 'rowSecurity' => true,
+ 'permissions' => [],
+ ]);
+
+ $response = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['$id'] . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], $this->getHeaders()), [
+ 'relatedTableId' => $table2['body']['$id'],
+ 'type' => 'manyToOne',
+ 'twoWay' => true,
+ 'onDelete' => 'cascade',
+ 'key' => 'level2',
+ 'twoWayKey' => 'level1'
+ ]);
+
+ $this->assertEquals(202, $response['headers']['status-code']);
+
+ sleep(1);
+
+ $response = $this->client->call(Client::METHOD_PUT, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rows' => [
+ [
+ '$id' => '1',
+ 'number' => 1000,
+ ],
+ ],
+ ]);
+
+ $this->assertEquals(400, $response['headers']['status-code']);
+ }
+
+ public function testBulkDelete(): void
+ {
+ // Create database
+ $database = $this->client->call(Client::METHOD_POST, '/databases', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], [
+ 'databaseId' => ID::unique(),
+ 'name' => 'Bulk Deletes'
+ ]);
+
+ $this->assertNotEmpty($database['body']['$id']);
+
+ $databaseId = $database['body']['$id'];
+
+ $table = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Bulk Deletes',
+ 'rowSecurity' => false,
+ 'permissions' => [
+ Permission::create(Role::any()),
+ Permission::read(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ ]);
+
+ $this->assertEquals(201, $table['headers']['status-code']);
+
+ $data = [
+ '$id' => $table['body']['$id'],
+ 'databaseId' => $table['body']['databaseId']
+ ];
+
+ // Await column
+ $numberColumn = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['$id'] . '/columns/integer', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'number',
+ 'required' => true,
+ ]);
+
+ $this->assertEquals(202, $numberColumn['headers']['status-code']);
+
+ // wait for database worker to create columns
+ sleep(2);
+
+ // Create rows
+ $createBulkRows = function ($amount = 11) use ($data) {
+ $rows = [];
+
+ for ($x = 0; $x < $amount; $x++) {
+ $rows[] = [
+ '$id' => ID::unique(),
+ 'number' => $x,
+ ];
+ }
+
+ $doc = $this->client->call(Client::METHOD_POST, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rows' => $rows,
+ ]);
+
+ $this->assertEquals(201, $doc['headers']['status-code']);
+ };
+
+ $createBulkRows();
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(11, $rows['body']['total']);
+
+ // TEST: Delete all rows
+ $response = $this->client->call(Client::METHOD_DELETE, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertEquals(11, $response['body']['total']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(0, $rows['body']['total']);
+
+ // TEST: Delete rows with query
+ $createBulkRows();
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(11, $rows['body']['total']);
+
+ $response = $this->client->call(Client::METHOD_DELETE, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::lessThan('number', 5)->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertEquals(5, $response['body']['total']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(6, $rows['body']['total']);
+
+ foreach ($rows['body']['rows'] as $row) {
+ $this->assertGreaterThanOrEqual(5, $row['number']);
+ }
+
+ // Cleanup
+ $response = $this->client->call(Client::METHOD_DELETE, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertEquals(6, $response['body']['total']);
+
+ // SUCCESS: Delete rows with query
+ $createBulkRows();
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(11, $rows['body']['total']);
+
+ $response = $this->client->call(Client::METHOD_DELETE, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::lessThan('number', 5)->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertEquals(5, $response['body']['total']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(6, $rows['body']['total']);
+
+ // Cleanup
+ $response = $this->client->call(Client::METHOD_DELETE, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertEquals(6, $response['body']['total']);
+
+ // SUCCESS: Delete Rows with limit query
+ $createBulkRows();
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(11, $rows['body']['total']);
+
+ $response = $this->client->call(Client::METHOD_DELETE, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::limit(2)->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertEquals(2, $response['body']['total']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(9, $rows['body']['total']);
+
+ // Cleanup
+ $response = $this->client->call(Client::METHOD_DELETE, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertEquals(9, $response['body']['total']);
+
+ // SUCCESS: Delete Rows with offset query
+ $createBulkRows();
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(11, $rows['body']['total']);
+
+ $response = $this->client->call(Client::METHOD_DELETE, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'queries' => [
+ Query::offset(5)->toString(),
+ ],
+ ]);
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertEquals(6, $response['body']['total']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(5, $rows['body']['total']);
+
+ $lastDoc = end($rows['body']['rows']);
+
+ $this->assertNotEmpty($lastDoc);
+ $this->assertEquals(4, $lastDoc['number']);
+
+ // Cleanup
+ $response = $this->client->call(Client::METHOD_DELETE, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertEquals(5, $response['body']['total']);
+
+ // SUCCESS: Delete 100 rows
+ $createBulkRows(100);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(100, $rows['body']['total']);
+
+ $response = $this->client->call(Client::METHOD_DELETE, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $response['headers']['status-code']);
+ $this->assertEquals(100, $response['body']['total']);
+
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals(0, $rows['body']['total']);
+
+ // TEST: Fail - Can't bulk delete in a table with relationships
+ $table2 = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Bulk Related',
+ 'rowSecurity' => true,
+ 'permissions' => [],
+ ]);
+
+ $response = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['$id'] . '/columns/relationship', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], $this->getHeaders()), [
+ 'relatedTableId' => $table2['body']['$id'],
+ 'type' => 'manyToOne',
+ 'twoWay' => true,
+ 'onDelete' => 'cascade',
+ 'key' => 'level2',
+ 'twoWayKey' => 'level1'
+ ]);
+
+ $this->assertEquals(202, $response['headers']['status-code']);
+
+ sleep(1);
+
+ $response = $this->client->call(Client::METHOD_DELETE, '/databases/' . $data['databaseId'] . '/tables/' . $data['$id'] . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(400, $response['headers']['status-code']);
+ }
+}
diff --git a/tests/e2e/Services/Databases/Tables/DatabasesPermissionsGuestTest.php b/tests/e2e/Services/Databases/Tables/DatabasesPermissionsGuestTest.php
new file mode 100644
index 0000000000..f404cc1bd5
--- /dev/null
+++ b/tests/e2e/Services/Databases/Tables/DatabasesPermissionsGuestTest.php
@@ -0,0 +1,278 @@
+client->call(Client::METHOD_POST, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'databaseId' => ID::unique(),
+ 'name' => 'InvalidRowDatabase',
+ ]);
+ $this->assertEquals(201, $database['headers']['status-code']);
+ $this->assertEquals('InvalidRowDatabase', $database['body']['name']);
+
+ $databaseId = $database['body']['$id'];
+ $publicMovies = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', $this->getServerHeader(), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Movies',
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::create(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ ]);
+ $privateMovies = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', $this->getServerHeader(), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Movies',
+ 'permissions' => [],
+ 'rowSecurity' => true,
+ ]);
+
+ $publicTable = ['id' => $publicMovies['body']['$id']];
+ $privateTable = ['id' => $privateMovies['body']['$id']];
+
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $publicTable['id'] . '/columns/string', $this->getServerHeader(), [
+ 'key' => 'title',
+ 'size' => 256,
+ 'required' => true,
+ ]);
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $privateTable['id'] . '/columns/string', $this->getServerHeader(), [
+ 'key' => 'title',
+ 'size' => 256,
+ 'required' => true,
+ ]);
+
+ sleep(2);
+
+ return [
+ 'databaseId' => $databaseId,
+ 'publicTableId' => $publicTable['id'],
+ 'privateTableId' => $privateTable['id'],
+ ];
+ }
+
+ public function permissionsProvider(): array
+ {
+ return [
+ [[Permission::read(Role::any())]],
+ [[Permission::read(Role::users())]],
+ [[Permission::update(Role::any()), Permission::delete(Role::any())]],
+ [[Permission::read(Role::any()), Permission::update(Role::any()), Permission::delete(Role::any())]],
+ [[Permission::read(Role::users()), Permission::update(Role::users()), Permission::delete(Role::users())]],
+ [[Permission::read(Role::any()), Permission::update(Role::users()), Permission::delete(Role::users())]],
+ ];
+ }
+
+ /**
+ * @dataProvider permissionsProvider
+ */
+ public function testReadRows($permissions)
+ {
+ $data = $this->createTable();
+ $publicTableId = $data['publicTableId'];
+ $privateTableId = $data['privateTableId'];
+ $databaseId = $data['databaseId'];
+
+ $publicResponse = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $publicTableId . '/rows', $this->getServerHeader(), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Lorem',
+ ],
+ 'permissions' => $permissions,
+ ]);
+ $privateResponse = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $privateTableId . '/rows', $this->getServerHeader(), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Lorem',
+ ],
+ 'permissions' => $permissions,
+ ]);
+
+ $this->assertEquals(201, $publicResponse['headers']['status-code']);
+ $this->assertEquals(201, $privateResponse['headers']['status-code']);
+
+ $roles = Authorization::getRoles();
+ Authorization::cleanRoles();
+
+ $publicRows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $publicTableId . '/rows', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ]);
+ $privateRows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $privateTableId . '/rows', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ]);
+
+ $this->assertEquals(1, $publicRows['body']['total']);
+ $this->assertEquals($permissions, $publicRows['body']['rows'][0]['$permissions']);
+
+ if (\in_array(Permission::read(Role::any()), $permissions)) {
+ $this->assertEquals(1, $privateRows['body']['total']);
+ $this->assertEquals($permissions, $privateRows['body']['rows'][0]['$permissions']);
+ } else {
+ $this->assertEquals(0, $privateRows['body']['total']);
+ }
+
+ foreach ($roles as $role) {
+ Authorization::setRole($role);
+ }
+ }
+
+ public function testWriteRow()
+ {
+ $data = $this->createTable();
+ $publicTableId = $data['publicTableId'];
+ $privateTableId = $data['privateTableId'];
+ $databaseId = $data['databaseId'];
+
+ $roles = Authorization::getRoles();
+ Authorization::cleanRoles();
+
+ $publicResponse = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $publicTableId . '/rows', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Lorem',
+ ]
+ ]);
+
+ $publicRowId = $publicResponse['body']['$id'];
+ $this->assertEquals(201, $publicResponse['headers']['status-code']);
+
+ $privateResponse = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $privateTableId . '/rows', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Lorem',
+ ],
+ ]);
+
+ $this->assertEquals(401, $privateResponse['headers']['status-code']);
+
+ // Create a row in private collection with API key so we can test that update and delete are also not allowed
+ $privateResponse = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $privateTableId . '/rows', $this->getServerHeader(), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Lorem',
+ ],
+ ]);
+
+ $this->assertEquals(201, $privateResponse['headers']['status-code']);
+ $privateRowId = $privateResponse['body']['$id'];
+
+ $publicRow = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $publicTableId . '/rows/' . $publicRowId, [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], [
+ 'data' => [
+ 'title' => 'Thor: Ragnarok',
+ ],
+ ]);
+
+ $this->assertEquals(200, $publicRow['headers']['status-code']);
+ $this->assertEquals('Thor: Ragnarok', $publicRow['body']['title']);
+
+ $privateRow = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $privateTableId . '/rows/' . $privateRowId, [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], [
+ 'data' => [
+ 'title' => 'Thor: Ragnarok',
+ ],
+ ]);
+
+ $this->assertEquals(401, $privateRow['headers']['status-code']);
+
+ $publicRow = $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $publicTableId . '/rows/' . $publicRowId, [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ]);
+
+ $this->assertEquals(204, $publicRow['headers']['status-code']);
+
+ $privateRow = $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $privateTableId . '/rows/' . $privateRowId, [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ]);
+
+ $this->assertEquals(401, $privateRow['headers']['status-code']);
+
+ foreach ($roles as $role) {
+ Authorization::setRole($role);
+ }
+ }
+
+ public function testWriteRowWithPermissions()
+ {
+ $database = $this->client->call(Client::METHOD_POST, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'databaseId' => ID::unique(),
+ 'name' => 'GuestPermissionsWrite',
+ ]);
+ $this->assertEquals(201, $database['headers']['status-code']);
+ $this->assertEquals('GuestPermissionsWrite', $database['body']['name']);
+
+ $databaseId = $database['body']['$id'];
+ $movies = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', $this->getServerHeader(), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Movies',
+ 'permissions' => [
+ Permission::create(Role::any()),
+ ],
+ 'rowSecurity' => true
+ ]);
+
+ $moviesId = $movies['body']['$id'];
+
+ $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $moviesId . '/columns/string', $this->getServerHeader(), [
+ 'key' => 'title',
+ 'size' => 256,
+ 'required' => true,
+ ]);
+
+ sleep(1);
+
+ $row = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $moviesId . '/rows', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Thor: Ragnarok',
+ ],
+ 'permissions' => [
+ Permission::read(Role::any()),
+ ]
+ ]);
+
+ $this->assertEquals(201, $row['headers']['status-code']);
+ $this->assertEquals('Thor: Ragnarok', $row['body']['title']);
+ }
+}
diff --git a/tests/e2e/Services/Databases/Tables/DatabasesPermissionsMemberTest.php b/tests/e2e/Services/Databases/Tables/DatabasesPermissionsMemberTest.php
new file mode 100644
index 0000000000..f1e5c35482
--- /dev/null
+++ b/tests/e2e/Services/Databases/Tables/DatabasesPermissionsMemberTest.php
@@ -0,0 +1,271 @@
+ $this->createUser('user1', 'lorem@ipsum.com'),
+ 'user2' => $this->createUser('user2', 'dolor@ipsum.com'),
+ ];
+ }
+
+ public function permissionsProvider(): array
+ {
+ return [
+ [
+ 'permissions' => [Permission::read(Role::any())],
+ 'any' => 1,
+ 'users' => 1,
+ 'doconly' => 1,
+ ],
+ [
+ 'permissions' => [Permission::read(Role::users())],
+ 'any' => 2,
+ 'users' => 2,
+ 'doconly' => 2,
+ ],
+ [
+ 'permissions' => [Permission::read(Role::user(ID::custom('random')))],
+ 'any' => 3,
+ 'users' => 3,
+ 'doconly' => 2,
+ ],
+ [
+ 'permissions' => [Permission::read(Role::user(ID::custom('lorem'))), Permission::update(Role::user('lorem')), Permission::delete(Role::user('lorem'))],
+ 'any' => 4,
+ 'users' => 4,
+ 'doconly' => 2,
+ ],
+ [
+ 'permissions' => [Permission::read(Role::user(ID::custom('dolor'))), Permission::update(Role::user('dolor')), Permission::delete(Role::user('dolor'))],
+ 'any' => 5,
+ 'users' => 5,
+ 'doconly' => 2,
+ ],
+ [
+ 'permissions' => [Permission::read(Role::user(ID::custom('dolor'))), Permission::read(Role::user('lorem')), Permission::update(Role::user('dolor')), Permission::delete(Role::user('dolor'))],
+ 'any' => 6,
+ 'users' => 6,
+ 'doconly' => 2,
+ ],
+ [
+ 'permissions' => [Permission::update(Role::any()), Permission::delete(Role::any())],
+ 'any' => 7,
+ 'users' => 7,
+ 'doconly' => 2,
+ ],
+ [
+ 'permissions' => [Permission::read(Role::any()), Permission::update(Role::any()), Permission::delete(Role::any())],
+ 'any' => 8,
+ 'users' => 8,
+ 'doconly' => 3,
+ ],
+ [
+ 'permissions' => [Permission::read(Role::any()), Permission::update(Role::users()), Permission::delete(Role::users())],
+ 'any' => 9,
+ 'users' => 9,
+ 'doconly' => 4,
+ ],
+ [
+ 'permissions' => [Permission::read(Role::user(ID::custom('user1')))],
+ 'any' => 10,
+ 'users' => 10,
+ 'doconly' => 5,
+ ],
+ [
+ 'permissions' => [Permission::read(Role::user(ID::custom('user1'))), Permission::read(Role::user(ID::custom('user1')))],
+ 'any' => 11,
+ 'users' => 11,
+ 'doconly' => 6,
+ ],
+ [
+ 'permissions' => [Permission::read(Role::users()), Permission::update(Role::users()), Permission::delete(Role::users())],
+ 'any' => 12,
+ 'users' => 12,
+ 'doconly' => 7,
+ ],
+ ];
+ }
+
+ /**
+ * Setup database
+ *
+ * Data providers lose object state so explicitly pass [$users, $tables] to each iteration
+ *
+ * @return array
+ * @throws \Exception
+ */
+ public function testSetupDatabase(): array
+ {
+ $this->createUsers();
+
+ $db = $this->client->call(Client::METHOD_POST, '/databases', $this->getServerHeader(), [
+ 'databaseId' => ID::unique(),
+ 'name' => 'Test Database',
+ ]);
+ $this->assertEquals(201, $db['headers']['status-code']);
+
+ $databaseId = $db['body']['$id'];
+
+ $public = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', $this->getServerHeader(), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Movies',
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::create(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ 'rowSecurity' => true,
+ ]);
+ $this->assertEquals(201, $public['headers']['status-code']);
+ $this->tables = ['public' => $public['body']['$id']];
+
+ $response = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $this->tables['public'] . '/columns/string', $this->getServerHeader(), [
+ 'key' => 'title',
+ 'size' => 256,
+ 'required' => true,
+ ]);
+ $this->assertEquals(202, $response['headers']['status-code']);
+
+ $private = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', $this->getServerHeader(), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Private Movies',
+ 'permissions' => [
+ Permission::read(Role::users()),
+ Permission::create(Role::users()),
+ Permission::update(Role::users()),
+ Permission::delete(Role::users()),
+ ],
+ 'rowSecurity' => true,
+ ]);
+ $this->assertEquals(201, $private['headers']['status-code']);
+ $this->tables['private'] = $private['body']['$id'];
+
+ $response = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $this->tables['private'] . '/columns/string', $this->getServerHeader(), [
+ 'key' => 'title',
+ 'size' => 256,
+ 'required' => true,
+ ]);
+ $this->assertEquals(202, $response['headers']['status-code']);
+
+ $doconly = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', $this->getServerHeader(), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Row Only Movies',
+ 'permissions' => [],
+ 'rowSecurity' => true,
+ ]);
+ $this->assertEquals(201, $private['headers']['status-code']);
+ $this->tables['doconly'] = $doconly['body']['$id'];
+
+ $response = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $this->tables['doconly'] . '/columns/string', $this->getServerHeader(), [
+ 'key' => 'title',
+ 'size' => 256,
+ 'required' => true,
+ ]);
+ $this->assertEquals(202, $response['headers']['status-code']);
+
+ sleep(2);
+
+ return [
+ 'users' => $this->users,
+ 'tables' => $this->tables,
+ 'databaseId' => $databaseId
+ ];
+ }
+
+ /**
+ * Data provider params are passed before test dependencies
+ * @dataProvider permissionsProvider
+ * @depends testSetupDatabase
+ */
+ public function testReadRows($permissions, $anyCount, $usersCount, $docOnlyCount, $data)
+ {
+ $users = $data['users'];
+ $tables = $data['tables'];
+ $databaseId = $data['databaseId'];
+
+ $response = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tables['public'] . '/rows', $this->getServerHeader(), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Lorem',
+ ],
+ 'permissions' => $permissions
+ ]);
+ $this->assertEquals(201, $response['headers']['status-code']);
+
+ $response = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tables['private'] . '/rows', $this->getServerHeader(), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Lorem',
+ ],
+ 'permissions' => $permissions
+ ]);
+ $this->assertEquals(201, $response['headers']['status-code']);
+
+ $response = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $tables['doconly'] . '/rows', $this->getServerHeader(), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Lorem',
+ ],
+ 'permissions' => $permissions
+ ]);
+ $this->assertEquals(201, $response['headers']['status-code']);
+
+ /**
+ * Check "any" permission table
+ */
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tables['public'] . '/rows', [
+ 'origin' => 'http://localhost',
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'cookie' => 'a_session_' . $this->getProject()['$id'] . '=' . $users['user1']['session'],
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals($anyCount, $rows['body']['total']);
+
+ /**
+ * Check "users" permission table
+ */
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tables['private'] . '/rows', [
+ 'origin' => 'http://localhost',
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'cookie' => 'a_session_' . $this->getProject()['$id'] . '=' . $users['user1']['session'],
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals($usersCount, $rows['body']['total']);
+
+ /**
+ * Check "user:user1" row only permission table
+ */
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $databaseId . '/tables/' . $tables['doconly'] . '/rows', [
+ 'origin' => 'http://localhost',
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'cookie' => 'a_session_' . $this->getProject()['$id'] . '=' . $users['user1']['session'],
+ ]);
+
+ $this->assertEquals(200, $rows['headers']['status-code']);
+ $this->assertEquals($docOnlyCount, $rows['body']['total']);
+ }
+}
diff --git a/tests/e2e/Services/Databases/Tables/DatabasesPermissionsScope.php b/tests/e2e/Services/Databases/Tables/DatabasesPermissionsScope.php
new file mode 100644
index 0000000000..a2bc227c8f
--- /dev/null
+++ b/tests/e2e/Services/Databases/Tables/DatabasesPermissionsScope.php
@@ -0,0 +1,87 @@
+client->call(Client::METHOD_POST, '/account', [
+ 'origin' => 'http://localhost',
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-dev-key' => $this->getProject()['devKey'] ?? '',
+ ], [
+ 'userId' => $id,
+ 'email' => $email,
+ 'password' => $password
+ ]);
+
+ $this->assertEquals(201, $user['headers']['status-code']);
+
+ $session = $this->client->call(Client::METHOD_POST, '/account/sessions/email', [
+ 'origin' => 'http://localhost',
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], [
+ 'email' => $email,
+ 'password' => $password,
+ ]);
+
+ $session = $session['cookies']['a_session_' . $this->getProject()['$id']];
+
+ $user = [
+ '$id' => $user['body']['$id'],
+ 'email' => $user['body']['email'],
+ 'session' => $session,
+ ];
+ $this->users[$id] = $user;
+
+ return $user;
+ }
+
+ public function getCreatedUser(string $id): array
+ {
+ return $this->users[$id] ?? [];
+ }
+
+ public function createTeam(string $id, string $name): array
+ {
+ $team = $this->client->call(Client::METHOD_POST, '/teams', $this->getServerHeader(), [
+ 'teamId' => $id,
+ 'name' => $name
+ ]);
+ $this->teams[$id] = $team['body'];
+
+ return $team['body'];
+ }
+
+ public function addToTeam(string $user, string $team, array $roles = []): array
+ {
+ $membership = $this->client->call(Client::METHOD_POST, '/teams/' . $team . '/memberships', $this->getServerHeader(), [
+ 'teamId' => $team,
+ 'email' => $this->getCreatedUser($user)['email'],
+ 'roles' => $roles,
+ 'url' => 'http://localhost:5000/join-us#title'
+ ]);
+
+ return [
+ 'user' => $membership['body']['userId'],
+ 'membership' => $membership['body']['$id']
+ ];
+ }
+
+ public function getServerHeader(): array
+ {
+ return [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ];
+ }
+}
diff --git a/tests/e2e/Services/Databases/Tables/DatabasesPermissionsTeamTest.php b/tests/e2e/Services/Databases/Tables/DatabasesPermissionsTeamTest.php
new file mode 100644
index 0000000000..406ca79371
--- /dev/null
+++ b/tests/e2e/Services/Databases/Tables/DatabasesPermissionsTeamTest.php
@@ -0,0 +1,208 @@
+ $this->createTeam('team1', 'Team 1'),
+ 'team2' => $this->createTeam('team2', 'Team 2'),
+ ];
+ }
+
+ public function createUsers(): array
+ {
+ return [
+ 'user1' => $this->createUser('user1', 'lorem@ipsum.com'),
+ 'user2' => $this->createUser('user2', 'dolor@ipsum.com'),
+ 'user3' => $this->createUser('user3', 'sit@ipsum.com'),
+ ];
+ }
+
+ public function createTables($teams)
+ {
+ $db = $this->client->call(Client::METHOD_POST, '/databases', $this->getServerHeader(), [
+ 'databaseId' => $this->databaseId,
+ 'name' => 'Test Database',
+ ]);
+ $this->assertEquals(201, $db['headers']['status-code']);
+
+ $table1 = $this->client->call(Client::METHOD_POST, '/databases/' . $this->databaseId . '/tables', $this->getServerHeader(), [
+ 'tableId' => ID::custom('table1'),
+ 'name' => 'Table 1',
+ 'permissions' => [
+ Permission::read(Role::team($teams['team1']['$id'])),
+ Permission::create(Role::team($teams['team1']['$id'], 'admin')),
+ Permission::update(Role::team($teams['team1']['$id'], 'admin')),
+ Permission::delete(Role::team($teams['team1']['$id'], 'admin')),
+ ],
+ ]);
+
+ $this->tables['table1'] = $table1['body']['$id'];
+
+ $this->client->call(Client::METHOD_POST, '/databases/' . $this->databaseId . '/tables/' . $this->tables['table1'] . '/columns/string', $this->getServerHeader(), [
+ 'key' => 'title',
+ 'size' => 256,
+ 'required' => true,
+ ]);
+
+ $table2 = $this->client->call(Client::METHOD_POST, '/databases/' . $this->databaseId . '/tables', $this->getServerHeader(), [
+ 'tableId' => ID::custom('table2'),
+ 'name' => 'Table 2',
+ 'permissions' => [
+ Permission::read(Role::team($teams['team2']['$id'])),
+ Permission::create(Role::team($teams['team2']['$id'], 'owner')),
+ Permission::update(Role::team($teams['team2']['$id'], 'owner')),
+ Permission::delete(Role::team($teams['team2']['$id'], 'owner')),
+ ]
+ ]);
+
+ $this->tables['table2'] = $table2['body']['$id'];
+
+ $this->client->call(Client::METHOD_POST, '/databases/' . $this->databaseId . '/tables/' . $this->tables['table2'] . '/columns/string', $this->getServerHeader(), [
+ 'key' => 'title',
+ 'size' => 256,
+ 'required' => true,
+ ]);
+
+ sleep(2);
+
+ return $this->tables;
+ }
+
+ /*
+ * $success = can $user read from $table
+ * [$user, $table, $success]
+ */
+ public function readRowsProvider(): array
+ {
+ return [
+ ['user1', 'table1', true],
+ ['user2', 'table1', false],
+ ['user3', 'table1', true],
+ ['user1', 'table2', false],
+ ['user2', 'table2', true],
+ ['user3', 'table2', true],
+ ];
+ }
+
+ /*
+ * $success = can $user write to $table
+ * [$user, $table, $success]
+ */
+ public function writeRowsProvider(): array
+ {
+ return [
+ ['user1', 'table1', true],
+ ['user2', 'table1', false],
+ ['user3', 'table1', false],
+ ['user1', 'table2', false],
+ ['user2', 'table2', true],
+ ['user3', 'table2', false],
+ ];
+ }
+
+ /**
+ * Setup database
+ *
+ * Data providers lose object state
+ * so explicitly pass $users to each iteration
+ * @return array $users
+ */
+ public function testSetupDatabase(): array
+ {
+ $this->createUsers();
+ $this->createTeams();
+
+ $this->addToTeam('user1', 'team1', ['admin']);
+ $this->addToTeam('user2', 'team2', ['owner']);
+
+ // user3 in both teams but with no roles
+ $this->addToTeam('user3', 'team1');
+ $this->addToTeam('user3', 'team2');
+
+ $this->createTables($this->teams);
+
+ $response = $this->client->call(Client::METHOD_POST, '/databases/' . $this->databaseId . '/tables/' . $this->tables['table1'] . '/rows', $this->getServerHeader(), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Lorem',
+ ],
+ ]);
+ $this->assertEquals(201, $response['headers']['status-code']);
+
+ $response = $this->client->call(Client::METHOD_POST, '/databases/' . $this->databaseId . '/tables/' . $this->tables['table2'] . '/rows', $this->getServerHeader(), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Ipsum',
+ ],
+ ]);
+ $this->assertEquals(201, $response['headers']['status-code']);
+
+ return $this->users;
+ }
+
+ /**
+ * Data provider params are passed before test dependencies
+ * @depends testSetupDatabase
+ * @dataProvider readRowsProvider
+ */
+ public function testReadRows($user, $table, $success, $users)
+ {
+ $rows = $this->client->call(Client::METHOD_GET, '/databases/' . $this->databaseId . '/tables/' . $table . '/rows', [
+ 'origin' => 'http://localhost',
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'cookie' => 'a_session_' . $this->getProject()['$id'] . '=' . $users[$user]['session'],
+ ]);
+
+ if ($success) {
+ $this->assertCount(1, $rows['body']['rows']);
+ } else {
+ $this->assertEquals(401, $rows['headers']['status-code']);
+ }
+ }
+
+ /**
+ * @depends testSetupDatabase
+ * @dataProvider writeRowsProvider
+ */
+ public function testWriteRows($user, $table, $success, $users)
+ {
+ $rows = $this->client->call(Client::METHOD_POST, '/databases/' . $this->databaseId . '/tables/' . $table . '/rows', [
+ 'origin' => 'http://localhost',
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'cookie' => 'a_session_' . $this->getProject()['$id'] . '=' . $users[$user]['session'],
+ ], [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'title' => 'Ipsum',
+ ],
+ ]);
+
+ if ($success) {
+ $this->assertEquals(201, $rows['headers']['status-code']);
+ } else {
+ // 401 if user is a part of team, 404 otherwise
+ $this->assertContains($rows['headers']['status-code'], [401, 404]);
+ }
+ }
+}
diff --git a/tests/e2e/Services/GraphQL/Base.php b/tests/e2e/Services/GraphQL/Base.php
index 121d40156e..554f84e616 100644
--- a/tests/e2e/Services/GraphQL/Base.php
+++ b/tests/e2e/Services/GraphQL/Base.php
@@ -13,12 +13,21 @@ trait Base
public static string $GET_DATABASE = 'get_database';
public static string $UPDATE_DATABASE = 'update_database';
public static string $DELETE_DATABASE = 'delete_database';
+
// Collections
public static string $CREATE_COLLECTION = 'create_collection';
public static string $GET_COLLECTION = 'get_collection';
public static string $GET_COLLECTIONS = 'list_collections';
public static string $UPDATE_COLLECTION = 'update_collection';
public static string $DELETE_COLLECTION = 'delete_collection';
+
+ // Tables
+ public static string $CREATE_TABLE = 'create_table';
+ public static string $GET_TABLE = 'get_table';
+ public static string $GET_TABLES = 'list_tables';
+ public static string $UPDATE_TABLE = 'update_table';
+ public static string $DELETE_TABLE = 'delete_table';
+
// Attributes
public static string $CREATE_STRING_ATTRIBUTE = 'create_string_attribute';
public static string $CREATE_INTEGER_ATTRIBUTE = 'create_integer_attribute';
@@ -45,18 +54,74 @@ trait Base
public static string $GET_ATTRIBUTES = 'get_attributes';
public static string $GET_ATTRIBUTE = 'get_attribute';
public static string $DELETE_ATTRIBUTE = 'delete_attribute';
- // Indexes
- public static string $CREATE_INDEX = 'create_index';
- public static string $GET_INDEXES = 'get_indexes';
- public static string $GET_INDEX = 'get_index';
- public static string $DELETE_INDEX = 'delete_index';
+
+ // Columns
+ public static string $CREATE_STRING_COLUMN = 'create_string_column';
+ public static string $CREATE_INTEGER_COLUMN = 'create_integer_column';
+ public static string $CREATE_FLOAT_COLUMN = 'create_float_column';
+ public static string $CREATE_BOOLEAN_COLUMN = 'create_boolean_column';
+ public static string $CREATE_URL_COLUMN = 'create_url_column';
+ public static string $CREATE_EMAIL_COLUMN = 'create_email_column';
+ public static string $CREATE_IP_COLUMN = 'create_ip_column';
+ public static string $CREATE_ENUM_COLUMN = 'create_enum_column';
+ public static string $CREATE_DATETIME_COLUMN = 'create_datetime_column';
+
+ public static string $CREATE_RELATIONSHIP_COLUMN = 'create_relationship_column';
+ public static string $UPDATE_STRING_COLUMN = 'update_string_column';
+ public static string $UPDATE_INTEGER_COLUMN = 'update_integer_column';
+ public static string $UPDATE_FLOAT_COLUMN = 'update_float_column';
+ public static string $UPDATE_BOOLEAN_COLUMN = 'update_boolean_column';
+ public static string $UPDATE_URL_COLUMN = 'update_url_column';
+ public static string $UPDATE_EMAIL_COLUMN = 'update_email_column';
+ public static string $UPDATE_IP_COLUMN = 'update_ip_column';
+ public static string $UPDATE_ENUM_COLUMN = 'update_enum_column';
+ public static string $UPDATE_DATETIME_COLUMN = 'update_datetime_column';
+
+ public static string $UPDATE_RELATIONSHIP_COLUMN = 'update_relationship_column';
+ public static string $GET_COLUMNS = 'get_columns';
+ public static string $GET_COLUMN = 'get_column';
+ public static string $DELETE_COLUMN = 'delete_column';
+
+ // Attribute Indexes
+ public static string $CREATE_INDEX = 'create_attribute_index';
+ public static string $GET_INDEXES = 'get_attribute_indexes';
+ public static string $GET_INDEX = 'get_attribute_index';
+ public static string $DELETE_INDEX = 'delete_attribute_index';
+
+ // Column Indexes
+ public static string $CREATE_COLUMN_INDEX = 'create_column_index';
+ public static string $GET_COLUMN_INDEXES = 'get_column_indexes';
+ public static string $GET_COLUMN_INDEX = 'get_column_index';
+ public static string $DELETE_COLUMN_INDEX = 'delete_column_index';
+
// Documents
public static string $CREATE_DOCUMENT = 'create_document_rest';
public static string $GET_DOCUMENTS = 'list_documents';
public static string $GET_DOCUMENT = 'get_document';
public static string $UPDATE_DOCUMENT = 'update_document';
+ public static string $UPSERT_DOCUMENT = 'upsert_document';
public static string $DELETE_DOCUMENT = 'delete_document';
+ // Documents Bulk APIs
+ public static string $CREATE_DOCUMENTS = 'create_documents_rest';
+ public static string $UPDATE_DOCUMENTS = 'update_documents';
+ public static string $UPSERT_DOCUMENTS = 'upsert_documents';
+ public static string $DELETE_DOCUMENTS = 'delete_documents';
+
+ // Rows
+ public static string $CREATE_ROW = 'create_row_rest';
+ public static string $GET_ROWS = 'list_rows';
+ public static string $GET_ROW = 'get_row';
+ public static string $UPDATE_ROW = 'update_row';
+ public static string $UPSERT_ROW = 'upsert_row';
+ public static string $DELETE_ROW = 'delete_row';
+
+ // Rows Bulk APIs
+ public static string $CREATE_ROWS = 'create_rows_rest';
+ public static string $UPDATE_ROWS = 'update_rows';
+ public static string $UPSERT_ROWS = 'upsert_rows';
+ public static string $DELETE_ROWS = 'delete_rows';
+
// Custom Entities
public static string $CREATE_CUSTOM_ENTITY = 'create_custom_entity';
public static string $GET_CUSTOM_ENTITIES = 'get_custom_entities';
@@ -255,9 +320,10 @@ trait Base
public static string $UPDATE_PUSH_NOTIFICATION = 'update_push_notification';
// Complex queries
- public static string $COMPLEX_QUERY = 'complex_query';
+ public static string $COMPLEX_QUERY_TABLE = 'complex_query_table';
+ public static string $COMPLEX_QUERY_COLLECTION = 'complex_query_collection';
- // Fragments
+ // Attribute Fragments
public static string $FRAGMENT_ATTRIBUTES = '
fragment attributeProperties on Attributes {
... on AttributeString {
@@ -332,6 +398,81 @@ trait Base
}
';
+ // Column Fragments
+ public static string $FRAGMENT_COLUMNS = '
+ fragment columnProperties on Columns {
+ ... on ColumnString {
+ key
+ required
+ array
+ status
+ default
+ size
+ }
+ ... on ColumnInteger {
+ key
+ required
+ array
+ status
+ intDefault: default
+ intMin: min
+ intMax: max
+ }
+ ... on ColumnFloat {
+ key
+ required
+ array
+ status
+ floatDefault: default
+ floatMin: min
+ floatMax: max
+ }
+ ... on ColumnBoolean {
+ key
+ required
+ array
+ status
+ boolDefault: default
+ }
+ ... on ColumnUrl {
+ key
+ required
+ array
+ status
+ default
+ }
+ ... on ColumnEmail {
+ key
+ required
+ array
+ status
+ default
+ }
+ ... on ColumnIp {
+ key
+ required
+ array
+ status
+ default
+ }
+ ... on ColumnEnum {
+ key
+ required
+ array
+ status
+ default
+ elements
+ }
+ ... on ColumnDatetime {
+ key
+ required
+ array
+ status
+ default
+ }
+ }
+ ';
+
public static string $FRAGMENT_HASH_OPTIONS = '
fragment options on HashOptions {
... on AlgoArgon2 {
@@ -438,6 +579,51 @@ trait Base
status
}
}';
+ case self::$GET_TABLE:
+ return 'query tablesGet($databaseId: String!, $tableId: String!) {
+ tablesGet(databaseId: $databaseId, tableId: $tableId) {
+ _id
+ _permissions
+ rowSecurity
+ name
+ }
+ }';
+ case self::$GET_TABLES:
+ return 'query tablesList($databaseId: String!) {
+ tablesList(databaseId: $databaseId) {
+ total
+ tables {
+ _id
+ _permissions
+ rowSecurity
+ name
+ }
+ }
+ }';
+ case self::$CREATE_TABLE:
+ return 'mutation tablesCreate($databaseId: String!, $tableId: String!, $name: String!, $rowSecurity: Boolean!, $permissions: [String!]!) {
+ tablesCreate(databaseId: $databaseId, tableId: $tableId, name: $name, rowSecurity: $rowSecurity, permissions: $permissions) {
+ _id
+ _permissions
+ rowSecurity
+ name
+ }
+ }';
+ case self::$UPDATE_TABLE:
+ return 'mutation tablesUpdate($databaseId: String!, $tableId: String!, $name: String!, $rowSecurity: Boolean!, $permissions: [String!], $enabled: Boolean) {
+ tablesUpdate(databaseId: $databaseId, tableId: $tableId, name: $name, rowSecurity: $rowSecurity, permissions: $permissions, enabled: $enabled) {
+ _id
+ _permissions
+ rowSecurity
+ name
+ }
+ }';
+ case self::$DELETE_TABLE:
+ return 'mutation tablesDelete($databaseId: String!, $tableId: String!) {
+ tablesDelete(databaseId: $databaseId, tableId: $tableId) {
+ status
+ }
+ }';
case self::$CREATE_STRING_ATTRIBUTE:
return 'mutation createStringAttribute($databaseId: String!, $collectionId: String!, $key: String!, $size: Int!, $required: Boolean!, $default: String, $array: Boolean){
databasesCreateStringAttribute(databaseId: $databaseId, collectionId: $collectionId, key: $key, size: $size, required: $required, default: $default, array: $array) {
@@ -614,6 +800,182 @@ trait Base
onDelete
}
}';
+ case self::$CREATE_STRING_COLUMN:
+ return 'mutation createStringColumn($databaseId: String!, $tableId: String!, $key: String!, $size: Int!, $required: Boolean!, $default: String, $array: Boolean){
+ tablesCreateStringColumn(databaseId: $databaseId, tableId: $tableId, key: $key, size: $size, required: $required, default: $default, array: $array) {
+ key
+ required
+ default
+ array
+ }
+ }';
+ case self::$CREATE_INTEGER_COLUMN:
+ return 'mutation createIntegerColumn($databaseId: String!, $tableId: String!, $key: String!, $required: Boolean!, $min: Int, $max: Int, $default: Int, $array: Boolean){
+ tablesCreateIntegerColumn(databaseId: $databaseId, tableId: $tableId, key: $key, min: $min, max: $max, required: $required, default: $default, array: $array) {
+ key
+ required
+ min
+ max
+ default
+ array
+ }
+ }';
+ case self::$CREATE_FLOAT_COLUMN:
+ return 'mutation createFloatColumn($databaseId: String!, $tableId: String!, $key: String!, $required: Boolean!, $min: Float, $max: Float, $default: Float, $array: Boolean){
+ tablesCreateFloatColumn(databaseId: $databaseId, tableId: $tableId, key: $key, min: $min, max: $max, required: $required, default: $default, array: $array) {
+ key
+ required
+ min
+ max
+ default
+ array
+ }
+ }';
+ case self::$CREATE_BOOLEAN_COLUMN:
+ return 'mutation createBooleanColumn($databaseId: String!, $tableId: String!, $key: String!, $required: Boolean!, $default: Boolean, $array: Boolean){
+ tablesCreateBooleanColumn(databaseId: $databaseId, tableId: $tableId, key: $key, required: $required, default: $default, array: $array) {
+ key
+ required
+ default
+ array
+ }
+ }';
+ case self::$CREATE_URL_COLUMN:
+ return 'mutation createUrlColumn($databaseId: String!, $tableId: String!, $key: String!, $required: Boolean!, $default: String, $array: Boolean){
+ tablesCreateUrlColumn(databaseId: $databaseId, tableId: $tableId, key: $key, required: $required, default: $default, array: $array) {
+ key
+ required
+ default
+ array
+ }
+ }';
+ case self::$CREATE_EMAIL_COLUMN:
+ return 'mutation createEmailColumn($databaseId: String!, $tableId: String!, $key: String!, $required: Boolean!, $default: String, $array: Boolean){
+ tablesCreateEmailColumn(databaseId: $databaseId, tableId: $tableId, key: $key, required: $required, default: $default, array: $array) {
+ key
+ required
+ default
+ array
+ }
+ }';
+ case self::$CREATE_IP_COLUMN:
+ return 'mutation createIpColumn($databaseId: String!, $tableId: String!, $key: String!, $required: Boolean!, $default: String, $array: Boolean){
+ tablesCreateIpColumn(databaseId: $databaseId, tableId: $tableId, key: $key, required: $required, default: $default, array: $array) {
+ key
+ required
+ default
+ array
+ }
+ }';
+ case self::$CREATE_ENUM_COLUMN:
+ return 'mutation createEnumColumn($databaseId: String!, $tableId: String!, $key: String!, $elements: [String!]!, $required: Boolean!, $default: String, $array: Boolean){
+ tablesCreateEnumColumn(databaseId: $databaseId, tableId: $tableId, key: $key, elements: $elements, required: $required, default: $default, array: $array) {
+ key
+ elements
+ required
+ default
+ array
+ }
+ }';
+ case self::$CREATE_DATETIME_COLUMN:
+ return 'mutation createDatetimeColumn($databaseId: String!, $tableId: String!, $key: String!, $required: Boolean!, $default: String, $array: Boolean){
+ tablesCreateDatetimeColumn(databaseId: $databaseId, tableId: $tableId, key: $key, required: $required, default: $default, array: $array) {
+ key
+ required
+ default
+ array
+ }
+ }';
+ case self::$CREATE_RELATIONSHIP_COLUMN:
+ return 'mutation createRelationshipColumn($databaseId: String!, $tableId: String!, $relatedTableId: String!, $type: String!, $twoWay: Boolean, $key: String, $twoWayKey: String, $onDelete: String){
+ tablesCreateRelationshipColumn(databaseId: $databaseId, tableId: $tableId, relatedTableId: $relatedTableId, type: $type, twoWay: $twoWay, key: $key, twoWayKey: $twoWayKey, onDelete: $onDelete) {
+ relatedTable
+ relationType
+ twoWay
+ key
+ twoWayKey
+ onDelete
+ }
+ }';
+ case self::$UPDATE_STRING_COLUMN:
+ return 'mutation updateStringColumn($databaseId: String!, $tableId: String!, $key: String!, $required: Boolean!, $default: String){
+ tablesUpdateStringColumn(databaseId: $databaseId, tableId: $tableId, key: $key, required: $required, default: $default) {
+ required
+ default
+ }
+ }';
+ case self::$UPDATE_INTEGER_COLUMN:
+ return 'mutation updateIntegerColumn($databaseId: String!, $tableId: String!, $key: String!, $required: Boolean!, $min: Int!, $max: Int!, $default: Int){
+ tablesUpdateIntegerColumn(databaseId: $databaseId, tableId: $tableId, key: $key, required: $required, min: $min, max: $max, default: $default) {
+ required
+ min
+ max
+ default
+ }
+ }';
+ case self::$UPDATE_FLOAT_COLUMN:
+ return 'mutation updateFloatColumn($databaseId: String!, $tableId: String!, $key: String!, $required: Boolean!, $min: Float!, $max: Float!, $default: Float){
+ tablesUpdateFloatColumn(databaseId: $databaseId, tableId: $tableId, key: $key, min: $min, max: $max, required: $required, default: $default) {
+ required
+ min
+ max
+ default
+ }
+ }';
+ case self::$UPDATE_BOOLEAN_COLUMN:
+ return 'mutation updateBooleanColumn($databaseId: String!, $tableId: String!, $key: String!, $required: Boolean!, $default: Boolean){
+ tablesUpdateBooleanColumn(databaseId: $databaseId, tableId: $tableId, key: $key, required: $required, default: $default) {
+ required
+ default
+ }
+ }';
+ case self::$UPDATE_URL_COLUMN:
+ return 'mutation updateUrlColumn($databaseId: String!, $tableId: String!, $key: String!, $required: Boolean!, $default: String){
+ tablesUpdateUrlColumn(databaseId: $databaseId, tableId: $tableId, key: $key, required: $required, default: $default) {
+ required
+ default
+ }
+ }';
+ case self::$UPDATE_EMAIL_COLUMN:
+ return 'mutation updateEmailColumn($databaseId: String!, $tableId: String!, $key: String!, $required: Boolean!, $default: String){
+ tablesUpdateEmailColumn(databaseId: $databaseId, tableId: $tableId, key: $key, required: $required, default: $default) {
+ required
+ default
+ }
+ }';
+ case self::$UPDATE_IP_COLUMN:
+ return 'mutation updateIpColumn($databaseId: String!, $tableId: String!, $key: String!, $required: Boolean!, $default: String){
+ tablesUpdateIpColumn(databaseId: $databaseId, tableId: $tableId, key: $key, required: $required, default: $default) {
+ required
+ default
+ }
+ }';
+ case self::$UPDATE_ENUM_COLUMN:
+ return 'mutation updateEnumColumn($databaseId: String!, $tableId: String!, $key: String!, $elements: [String!]!, $required: Boolean!, $default: String){
+ tablesUpdateEnumColumn(databaseId: $databaseId, tableId: $tableId, key: $key, elements: $elements, required: $required, default: $default) {
+ elements
+ required
+ default
+ }
+ }';
+ case self::$UPDATE_DATETIME_COLUMN:
+ return 'mutation updateDatetimeColumn($databaseId: String!, $tableId: String!, $key: String!, $required: Boolean!, $default: String){
+ tablesUpdateDatetimeColumn(databaseId: $databaseId, tableId: $tableId, key: $key, required: $required, default: $default) {
+ required
+ default
+ }
+ }';
+ case self::$UPDATE_RELATIONSHIP_COLUMN:
+ return 'mutation updateRelationshipColumn($databaseId: String!, $tableId: String!, $key: String!, $onDelete: String){
+ tablesUpdateRelationshipColumn(databaseId: $databaseId, tableId: $tableId, key: $key, onDelete: $onDelete) {
+ relatedTable
+ relationType
+ twoWay
+ key
+ twoWayKey
+ onDelete
+ }
+ }';
case self::$CREATE_INDEX:
return 'mutation createIndex($databaseId: String!, $collectionId: String!, $key: String!, $type: String!, $attributes: [String!]!, $orders: [String!]){
databasesCreateIndex(databaseId: $databaseId, collectionId: $collectionId, key: $key, type: $type, attributes: $attributes, orders: $orders) {
@@ -647,6 +1009,39 @@ trait Base
status
}
}';
+ case self::$CREATE_COLUMN_INDEX:
+ return 'mutation createIndex($databaseId: String!, $tableId: String!, $key: String!, $type: String!, $columns: [String!]!, $orders: [String!]){
+ tablesCreateIndex(databaseId: $databaseId, tableId: $tableId, key: $key, type: $type, columns: $columns, orders: $orders) {
+ key
+ type
+ status
+ }
+ }';
+ case self::$GET_COLUMN_INDEXES:
+ return 'query listIndexes($databaseId: String!, $tableId: String!) {
+ tablesListIndexes(databaseId: $databaseId, tableId: $tableId) {
+ total
+ indexes {
+ key
+ type
+ status
+ }
+ }
+ }';
+ case self::$GET_COLUMN_INDEX:
+ return 'query getIndex($databaseId: String!, $tableId: String!, $key: String!) {
+ tablesGetIndex(databaseId: $databaseId, tableId: $tableId, key: $key) {
+ key
+ type
+ status
+ }
+ }';
+ case self::$DELETE_COLUMN_INDEX:
+ return 'mutation deleteIndex($databaseId: String!, $tableId: String!, $key: String!) {
+ tablesDeleteIndex(databaseId: $databaseId, tableId: $tableId, key: $key) {
+ status
+ }
+ }';
case self::$GET_ATTRIBUTES:
return 'query listAttributes($databaseId: String!, $collectionId: String!) {
databasesListAttributes(databaseId: $databaseId, collectionId: $collectionId) {
@@ -668,6 +1063,28 @@ trait Base
status
}
}';
+ case self::$GET_COLUMNS:
+ return 'query listColumns($databaseId: String!, $tableId: String!) {
+ tablesListColumns(databaseId: $databaseId, tableId: $tableId) {
+ total
+ columns {
+ ...columnProperties
+ }
+ }
+ }' . PHP_EOL . self::$FRAGMENT_COLUMNS;
+ case self::$GET_COLUMN:
+ return 'query getColumn($databaseId: String!, $tableId: String!, $key: String!) {
+ tablesGetColumn(databaseId: $databaseId, tableId: $tableId, key: $key) {
+ ...columnProperties
+ }
+ }' . PHP_EOL . self::$FRAGMENT_COLUMNS;
+ case self::$DELETE_COLUMN:
+ return 'mutation deleteColumn($databaseId: String!, $tableId: String!, $key: String!) {
+ tablesDeleteColumn(databaseId: $databaseId, tableId: $tableId, key: $key) {
+ status
+ }
+ }';
+
case self::$GET_DOCUMENT:
return 'query getDocument($databaseId: String!, $collectionId: String!, $documentId: String!) {
databasesGetDocument(databaseId: $databaseId, collectionId: $collectionId, documentId: $documentId) {
@@ -697,6 +1114,58 @@ trait Base
_permissions
}
}';
+ case self::$CREATE_DOCUMENTS:
+ return 'mutation createDocuments($databaseId: String!, $collectionId: String!, $documents: [Json!]!) {
+ databasesCreateDocuments(databaseId: $databaseId, collectionId: $collectionId, documents: $documents) {
+ documents {
+ _id
+ _collectionId
+ _permissions
+ data
+ }
+ }
+ }';
+ case self::$CREATE_ROWS:
+ return 'mutation createRows($databaseId: String!, $tableId: String!, $rows: [Json!]!) {
+ tablesCreateRows(databaseId: $databaseId, tableId: $tableId, rows: $rows) {
+ rows {
+ _id
+ _tableId
+ _permissions
+ data
+ }
+ }
+ }';
+ case self::$GET_ROW:
+ return 'query getRow($databaseId: String!, $tableId: String!, $rowId: String!) {
+ tablesGetRow(databaseId: $databaseId, tableId: $tableId, rowId: $rowId) {
+ _id
+ _tableId
+ _permissions
+ data
+ }
+ }';
+ case self::$GET_ROWS:
+ return 'query listRows($databaseId: String!, $tableId: String!, $queries: [String!] = []) {
+ tablesListRows(databaseId: $databaseId, tableId: $tableId, queries: $queries) {
+ total
+ rows {
+ _id
+ _databaseId
+ _tableId
+ _permissions
+ data
+ }
+ }
+ }';
+ case self::$CREATE_ROW:
+ return 'mutation createRow($databaseId: String!, $tableId: String!, $rowId: String!, $data: Json!, $permissions: [String!]) {
+ tablesCreateRow(databaseId: $databaseId, tableId: $tableId, rowId: $rowId, data: $data, permissions: $permissions) {
+ _id
+ _tableId
+ _permissions
+ }
+ }';
case self::$CREATE_CUSTOM_ENTITY:
return 'mutation createActor($name: String!, $age: Int!, $alive: Boolean!, $salary: Float, $email: String!, $role: String!, $dob: String!, $ip: String, $url: String){
actorsCreate(name: $name, age: $age, alive: $alive, salary: $salary, email: $email, role: $role, dob: $dob, ip: $ip, url: $url) {
@@ -764,13 +1233,120 @@ trait Base
data
}
}';
+ case self::$UPSERT_DOCUMENT:
+ return 'mutation upsertDocument($databaseId: String!, $collectionId: String!, $documentId: String!, $data: Json!, $permissions: [String!] = []) {
+ databasesUpsertDocument(databaseId: $databaseId, collectionId: $collectionId, documentId: $documentId, data: $data, permissions: $permissions) {
+ _id
+ _databaseId
+ _collectionId
+ data
+ }
+ }';
+ case self::$UPDATE_DOCUMENTS:
+ return 'mutation updateDocuments($databaseId: String!, $collectionId: String!, $data: Json!, $queries: [String!]) {
+ databasesUpdateDocuments(databaseId: $databaseId, collectionId: $collectionId, data: $data, queries: $queries) {
+ total
+ documents {
+ _id
+ _databaseId
+ _collectionId
+ _permissions
+ data
+ }
+ }
+ }';
+ case self::$UPSERT_DOCUMENTS:
+ return 'mutation upsertDocuments($databaseId: String!, $collectionId: String!, $documents: [Json!]!) {
+ databasesUpsertDocuments(databaseId: $databaseId, collectionId: $collectionId, documents: $documents) {
+ total
+ documents {
+ _id
+ _databaseId
+ _collectionId
+ _permissions
+ data
+ }
+ }
+ }';
+ case self::$DELETE_DOCUMENTS:
+ return 'mutation deleteDocuments($databaseId: String!, $collectionId: String!, $queries: [String!] = []) {
+ databasesDeleteDocuments(databaseId: $databaseId, collectionId: $collectionId, queries: $queries) {
+ total
+ documents {
+ _id
+ _databaseId
+ _collectionId
+ data
+ }
+ }
+ }';
case self::$DELETE_DOCUMENT:
return 'mutation deleteDocument($databaseId: String!, $collectionId: String!, $documentId: String!){
databasesDeleteDocument(databaseId: $databaseId, collectionId: $collectionId, documentId: $documentId) {
status
}
}';
-
+ case self::$UPDATE_ROW:
+ return 'mutation updateRow($databaseId: String!, $tableId: String!, $rowId: String!, $data: Json!, $permissions: [String!]) {
+ tablesUpdateRow(databaseId: $databaseId, tableId: $tableId, rowId: $rowId, data: $data, permissions: $permissions) {
+ _id
+ _tableId
+ data
+ }
+ }';
+ case self::$UPSERT_ROW:
+ return 'mutation upsertRow($databaseId: String!, $tableId: String!, $rowId: String!, $data: Json!, $permissions: [String!] = []) {
+ tablesUpsertRow(databaseId: $databaseId, tableId: $tableId, rowId: $rowId, data: $data, permissions: $permissions) {
+ _id
+ _databaseId
+ _tableId
+ data
+ }
+ }';
+ case self::$DELETE_ROW:
+ return 'mutation deleteRow($databaseId: String!, $tableId: String!, $rowId: String!) {
+ tablesDeleteRow(databaseId: $databaseId, tableId: $tableId, rowId: $rowId) {
+ status
+ }
+ }';
+ case self::$UPDATE_ROWS:
+ return 'mutation updateRows($databaseId: String!, $tableId: String!, $data: Json!, $queries: [String!]) {
+ tablesUpdateRows(databaseId: $databaseId, tableId: $tableId, data: $data, queries: $queries) {
+ total
+ rows {
+ _id
+ _databaseId
+ _tableId
+ _permissions
+ data
+ }
+ }
+ }';
+ case self::$UPSERT_ROWS:
+ return 'mutation upsertRows($databaseId: String!, $tableId: String!, $rows: [Json!]!) {
+ tablesUpsertRows(databaseId: $databaseId, tableId: $tableId, rows: $rows) {
+ total
+ rows {
+ _id
+ _databaseId
+ _tableId
+ _permissions
+ data
+ }
+ }
+ }';
+ case self::$DELETE_ROWS:
+ return 'mutation deleteRows($databaseId: String!, $tableId: String!, $queries: [String!] = []) {
+ tablesDeleteRows(databaseId: $databaseId, tableId: $tableId, queries: $queries) {
+ total
+ rows {
+ _id
+ _databaseId
+ _tableId
+ data
+ }
+ }
+ }';
case self::$GET_USER:
return 'query getUser($userId : String!) {
usersGet(userId : $userId) {
@@ -2245,7 +2821,7 @@ trait Base
status
}
}';
- case self::$COMPLEX_QUERY:
+ case self::$COMPLEX_QUERY_COLLECTION:
return 'mutation complex($databaseId: String!, $databaseName: String!, $collectionId: String!, $collectionName: String!, $documentSecurity: Boolean!, $collectionPermissions: [String!]!) {
databasesCreate(databaseId: $databaseId, name: $databaseName) {
_id
@@ -2256,7 +2832,7 @@ trait Base
_createdAt
_updatedAt
_permissions
- _databaseId
+ databaseId
name
documentSecurity
attributes {
@@ -2488,6 +3064,249 @@ trait Base
}
}
}' . PHP_EOL . self::$FRAGMENT_ATTRIBUTES;
+ case self::$COMPLEX_QUERY_TABLE:
+ return 'mutation complex($databaseId: String!, $databaseName: String!, $tableId: String!, $tableName: String!, $rowSecurity: Boolean!, $tablePermissions: [String!]!) {
+ databasesCreate(databaseId: $databaseId, name: $databaseName) {
+ _id
+ name
+ }
+ tablesCreate(databaseId: $databaseId, tableId: $tableId, name: $tableName, rowSecurity: $rowSecurity, permissions: $tablePermissions) {
+ _id
+ _createdAt
+ _updatedAt
+ _permissions
+ databaseId
+ name
+ rowSecurity
+ columns {
+ ...columnProperties
+ }
+ indexes {
+ key
+ type
+ status
+ }
+ }
+ tablesCreateStringColumn(databaseId: $databaseId, tableId: $tableId, key: "name", size: 255, required: true) {
+ key
+ type
+ status
+ size
+ required
+ default
+ array
+ }
+ tablesCreateIntegerColumn(databaseId: $databaseId, tableId: $tableId, key: "age", min: 0, max: 150, required: true) {
+ key
+ type
+ status
+ required
+ min
+ max
+ default
+ array
+ }
+ tablesCreateBooleanColumn(databaseId: $databaseId, tableId: $tableId, key: "alive", required: false, default: true) {
+ key
+ type
+ status
+ required
+ default
+ array
+ }
+ user1: usersCreate(userId: "unique()", email: "test1@appwrite.io", password: "password", name: "Tester 1") {
+ _id
+ _createdAt
+ _updatedAt
+ name
+ phone
+ email
+ status
+ registration
+ passwordUpdate
+ emailVerification
+ phoneVerification
+ prefs {
+ data
+ }
+ }
+ user2: usersCreate(userId: "unique()", email: "test2@appwrite.io", password: "password", name: "Tester 2") {
+ _id
+ _createdAt
+ _updatedAt
+ name
+ phone
+ email
+ status
+ registration
+ passwordUpdate
+ emailVerification
+ phoneVerification
+ prefs {
+ data
+ }
+ }
+ user3: usersCreate(userId: "unique()", email: "test3@appwrite.io", password: "password", name: "Tester 3") {
+ _id
+ _createdAt
+ _updatedAt
+ name
+ phone
+ email
+ status
+ registration
+ passwordUpdate
+ emailVerification
+ phoneVerification
+ prefs {
+ data
+ }
+ }
+ user4: usersCreate(userId: "unique()", email: "test4@appwrite.io", password: "password", name: "Tester 4") {
+ _id
+ _createdAt
+ _updatedAt
+ name
+ phone
+ email
+ status
+ registration
+ passwordUpdate
+ emailVerification
+ phoneVerification
+ prefs {
+ data
+ }
+ }
+ user5: usersCreate(userId: "unique()", email: "test5@appwrite.io", password: "password", name: "Tester 5") {
+ _id
+ _createdAt
+ _updatedAt
+ name
+ phone
+ email
+ status
+ registration
+ passwordUpdate
+ emailVerification
+ phoneVerification
+ prefs {
+ data
+ }
+ }
+ user6: usersCreate(userId: "unique()", email: "test6@appwrite.io", password: "password", name: "Tester 6") {
+ _id
+ _createdAt
+ _updatedAt
+ name
+ phone
+ email
+ status
+ registration
+ passwordUpdate
+ emailVerification
+ phoneVerification
+ prefs {
+ data
+ }
+ }
+ user7: usersCreate(userId: "unique()", email: "test7@appwrite.io", password: "password", name: "Tester 7") {
+ _id
+ _createdAt
+ _updatedAt
+ name
+ phone
+ email
+ status
+ registration
+ passwordUpdate
+ emailVerification
+ phoneVerification
+ prefs {
+ data
+ }
+ }
+ user8: usersCreate(userId: "unique()", email: "test8@appwrite.io", password: "password", name: "Tester 8") {
+ _id
+ _createdAt
+ _updatedAt
+ name
+ phone
+ email
+ status
+ registration
+ passwordUpdate
+ emailVerification
+ phoneVerification
+ prefs {
+ data
+ }
+ }
+ user9: usersCreate(userId: "unique()", email: "test9@appwrite.io", password: "password", name: "Tester 9") {
+ _id
+ _createdAt
+ _updatedAt
+ name
+ phone
+ email
+ status
+ registration
+ passwordUpdate
+ emailVerification
+ phoneVerification
+ prefs {
+ data
+ }
+ }
+ user10: usersCreate(userId: "unique()", email: "test10@appwrite.io", password: "password", name: "Tester 10") {
+ _id
+ _createdAt
+ _updatedAt
+ name
+ phone
+ email
+ status
+ registration
+ passwordUpdate
+ emailVerification
+ phoneVerification
+ prefs {
+ data
+ }
+ }
+ user11: usersCreate(userId: "unique()", email: "test11@appwrite.io", password: "password", name: "Tester 11") {
+ _id
+ _createdAt
+ _updatedAt
+ name
+ phone
+ email
+ status
+ registration
+ passwordUpdate
+ emailVerification
+ phoneVerification
+ prefs {
+ data
+ }
+ }
+ user12: usersCreate(userId: "unique()", email: "test12@appwrite.io", password: "password", name: "Tester 5") {
+ _id
+ _createdAt
+ _updatedAt
+ name
+ phone
+ email
+ status
+ registration
+ passwordUpdate
+ emailVerification
+ phoneVerification
+ prefs {
+ data
+ }
+ }
+ }' . PHP_EOL . self::$FRAGMENT_COLUMNS;
}
throw new \InvalidArgumentException('Invalid query type');
diff --git a/tests/e2e/Services/GraphQL/AbuseTest.php b/tests/e2e/Services/GraphQL/Legacy/AbuseTest.php
similarity index 96%
rename from tests/e2e/Services/GraphQL/AbuseTest.php
rename to tests/e2e/Services/GraphQL/Legacy/AbuseTest.php
index ea97492c2b..d579ddb128 100644
--- a/tests/e2e/Services/GraphQL/AbuseTest.php
+++ b/tests/e2e/Services/GraphQL/Legacy/AbuseTest.php
@@ -1,11 +1,12 @@
getProject()['$id'];
- $query = $this->getQuery(self::$COMPLEX_QUERY);
+ $query = $this->getQuery(self::$COMPLEX_QUERY_COLLECTION);
$graphQLPayload = [
'query' => $query,
'variables' => [
@@ -113,7 +114,7 @@ class AbuseTest extends Scope
$this->assertEquals('Too many queries.', $response['body']['message']);
}
- private function createCollection()
+ private function createCollection(): array
{
$projectId = $this->getProject()['$id'];
$query = $this->getQuery(self::$CREATE_DATABASE);
diff --git a/tests/e2e/Services/GraphQL/AuthTest.php b/tests/e2e/Services/GraphQL/Legacy/AuthTest.php
similarity index 99%
rename from tests/e2e/Services/GraphQL/AuthTest.php
rename to tests/e2e/Services/GraphQL/Legacy/AuthTest.php
index ecce29f2b3..0560a0ad2d 100644
--- a/tests/e2e/Services/GraphQL/AuthTest.php
+++ b/tests/e2e/Services/GraphQL/Legacy/AuthTest.php
@@ -1,11 +1,12 @@
assertIsNotArray($document['body']);
$this->assertEquals(204, $document['headers']['status-code']);
}
+
+ /**
+ * @throws \Exception
+ */
+ public function testBulkCreateDocuments(): array
+ {
+ $project = $this->getProject();
+ $projectId = $project['$id'];
+ $headers = [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ 'x-appwrite-key' => $project['apiKey'],
+ ];
+
+ // Step 1: Create database
+ $query = $this->getQuery(self::$CREATE_DATABASE);
+ $payload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => 'bulk',
+ 'name' => 'Bulk',
+ ],
+ ];
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+ $databaseId = $res['body']['data']['databasesCreate']['_id'];
+
+ // Step 2: Create collection
+ $query = $this->getQuery(self::$CREATE_COLLECTION);
+ $payload['query'] = $query;
+ $payload['variables'] = [
+ 'databaseId' => $databaseId,
+ 'collectionId' => 'operations',
+ 'name' => 'Operations',
+ 'documentSecurity' => false,
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ ];
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+ $collectionId = $res['body']['data']['databasesCreateCollection']['_id'];
+
+ // Step 3: Create attribute
+ $query = $this->getQuery(self::$CREATE_STRING_ATTRIBUTE);
+ $payload['query'] = $query;
+ $payload['variables'] = [
+ 'databaseId' => $databaseId,
+ 'collectionId' => $collectionId,
+ 'key' => 'name',
+ 'size' => 256,
+ 'required' => true,
+ ];
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+ sleep(1);
+
+ // Step 4: Create documents
+ $query = $this->getQuery(self::$CREATE_DOCUMENTS);
+ $documents = [];
+ for ($i = 1; $i <= 10; $i++) {
+ $documents[] = ['$id' => 'doc' . $i, 'name' => 'Doc #' . $i];
+ }
+
+ $payload['query'] = $query;
+ $payload['variables'] = [
+ 'databaseId' => $databaseId,
+ 'collectionId' => $collectionId,
+ 'documents' => $documents,
+ ];
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+ $this->assertCount(10, $res['body']['data']['databasesCreateDocuments']['documents']);
+
+ return [
+ 'databaseId' => $databaseId,
+ 'collectionId' => $collectionId,
+ 'projectId' => $projectId,
+ ];
+ }
+
+ /**
+ * @depends testBulkCreateDocuments
+ */
+ public function testBulkUpdateDocuments(array $data): array
+ {
+ $userId = $this->getUser()['$id'];
+ $permissions = [
+ Permission::read(Role::user($userId)),
+ Permission::update(Role::user($userId)),
+ Permission::delete(Role::user($userId)),
+ ];
+
+ $headers = [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $data['projectId'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ];
+
+ $query = $this->getQuery(self::$UPDATE_DOCUMENTS);
+ $payload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['databaseId'],
+ 'collectionId' => $data['collectionId'],
+ 'data' => [
+ 'name' => 'Docs Updated',
+ '$permissions' => $permissions,
+ ],
+ ],
+ ];
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+ $this->assertCount(10, $res['body']['data']['databasesUpdateDocuments']['documents']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testBulkUpdateDocuments
+ */
+ public function testBulkUpsertDocuments(array $data): array
+ {
+ $headers = [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $data['projectId'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ];
+
+ // Upsert: Update one, insert one
+ $query = $this->getQuery(self::$UPSERT_DOCUMENTS);
+ $payload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['databaseId'],
+ 'collectionId' => $data['collectionId'],
+ 'documents' => [
+ ['$id' => 'doc10', 'name' => 'Doc #1000'],
+ ['name' => 'Doc #11'],
+ ],
+ ],
+ ];
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+ $this->assertCount(2, $res['body']['data']['databasesUpsertDocuments']['documents']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testBulkUpsertDocuments
+ */
+ public function testBulkDeleteDocuments(array $data): array
+ {
+ $headers = [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $data['projectId'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ];
+
+ $query = $this->getQuery(self::$DELETE_DOCUMENTS);
+ $payload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['databaseId'],
+ 'collectionId' => $data['collectionId'],
+ ],
+ ];
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+ $this->assertCount(11, $res['body']['data']['databasesDeleteDocuments']['documents']);
+
+ return $data;
+ }
}
diff --git a/tests/e2e/Services/GraphQL/DatabaseServerTest.php b/tests/e2e/Services/GraphQL/Legacy/DatabaseServerTest.php
similarity index 89%
rename from tests/e2e/Services/GraphQL/DatabaseServerTest.php
rename to tests/e2e/Services/GraphQL/Legacy/DatabaseServerTest.php
index 87006a1bea..3ecc96eaa0 100644
--- a/tests/e2e/Services/GraphQL/DatabaseServerTest.php
+++ b/tests/e2e/Services/GraphQL/Legacy/DatabaseServerTest.php
@@ -1,12 +1,13 @@
$projectId,
], $this->getHeaders()), $gqlPayload);
+ // TODO: @itznotabug - check for `encrypt` attribute in string column's response body as well!
$this->assertArrayNotHasKey('errors', $attribute['body']);
$this->assertIsArray($attribute['body']['data']);
$this->assertIsArray($attribute['body']['data']['databasesCreateStringAttribute']);
@@ -1463,4 +1465,176 @@ class DatabaseServerTest extends Scope
$this->assertIsNotArray($database['body']);
$this->assertEquals(204, $database['headers']['status-code']);
}
+
+ /**
+ * @throws Exception
+ */
+ public function testBulkCreateDocuments(): array
+ {
+ $project = $this->getProject();
+ $projectId = $project['$id'];
+ $headers = array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders());
+
+ // Step 1: Create database
+ $query = $this->getQuery(self::$CREATE_DATABASE);
+ $payload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => 'bulk',
+ 'name' => 'Bulk',
+ ],
+ ];
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+ $databaseId = $res['body']['data']['databasesCreate']['_id'];
+
+ // Step 2: Create collection
+ $query = $this->getQuery(self::$CREATE_COLLECTION);
+ $payload['query'] = $query;
+ $payload['variables'] = [
+ 'databaseId' => $databaseId,
+ 'collectionId' => 'operations',
+ 'name' => 'Operations',
+ 'documentSecurity' => false,
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ ];
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+ $collectionId = $res['body']['data']['databasesCreateCollection']['_id'];
+
+ // Step 3: Create attribute
+ $query = $this->getQuery(self::$CREATE_STRING_ATTRIBUTE);
+ $payload['query'] = $query;
+ $payload['variables'] = [
+ 'databaseId' => $databaseId,
+ 'collectionId' => $collectionId,
+ 'key' => 'name',
+ 'size' => 256,
+ 'required' => true,
+ ];
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+ sleep(1);
+
+ // Step 4: Create documents
+ $query = $this->getQuery(self::$CREATE_DOCUMENTS);
+ $documents = [];
+ for ($i = 1; $i <= 10; $i++) {
+ $documents[] = ['$id' => 'doc' . $i, 'name' => 'Doc #' . $i];
+ }
+
+ $payload['query'] = $query;
+ $payload['variables'] = [
+ 'databaseId' => $databaseId,
+ 'collectionId' => $collectionId,
+ 'documents' => $documents,
+ ];
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+ $this->assertCount(10, $res['body']['data']['databasesCreateDocuments']['documents']);
+
+ return [
+ 'databaseId' => $databaseId,
+ 'collectionId' => $collectionId,
+ 'projectId' => $projectId,
+ ];
+ }
+
+ /**
+ * @depends testBulkCreateDocuments
+ */
+ public function testBulkUpdateDocuments(array $data): array
+ {
+ $userId = $this->getUser()['$id'];
+ $permissions = [
+ Permission::read(Role::user($userId)),
+ Permission::update(Role::user($userId)),
+ Permission::delete(Role::user($userId)),
+ ];
+
+ $headers = array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $data['projectId'],
+ ], $this->getHeaders());
+
+ $query = $this->getQuery(self::$UPDATE_DOCUMENTS);
+ $payload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['databaseId'],
+ 'collectionId' => $data['collectionId'],
+ 'data' => [
+ 'name' => 'Docs Updated',
+ '$permissions' => $permissions,
+ ],
+ ],
+ ];
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+ $this->assertCount(10, $res['body']['data']['databasesUpdateDocuments']['documents']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testBulkUpdateDocuments
+ */
+ public function testBulkUpsertDocuments(array $data): array
+ {
+ $headers = array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $data['projectId'],
+ ], $this->getHeaders());
+
+ // Upsert: Update one, insert one
+ $query = $this->getQuery(self::$UPSERT_DOCUMENTS);
+ $payload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['databaseId'],
+ 'collectionId' => $data['collectionId'],
+ 'documents' => [
+ ['$id' => 'doc10', 'name' => 'Doc #1000'],
+ ['name' => 'Doc #11'],
+ ],
+ ],
+ ];
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+ $this->assertCount(2, $res['body']['data']['databasesUpsertDocuments']['documents']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testBulkUpsertDocuments
+ */
+ public function testBulkDeleteDocuments(array $data): array
+ {
+ $headers = array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $data['projectId'],
+ ], $this->getHeaders());
+
+ $query = $this->getQuery(self::$DELETE_DOCUMENTS);
+ $payload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['databaseId'],
+ 'collectionId' => $data['collectionId'],
+ ],
+ ];
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+ $this->assertCount(11, $res['body']['data']['databasesDeleteDocuments']['documents']);
+
+ return $data;
+ }
}
diff --git a/tests/e2e/Services/GraphQL/Tables/AbuseTest.php b/tests/e2e/Services/GraphQL/Tables/AbuseTest.php
new file mode 100644
index 0000000000..88c216dd5a
--- /dev/null
+++ b/tests/e2e/Services/GraphQL/Tables/AbuseTest.php
@@ -0,0 +1,185 @@
+markTestSkipped('Abuse is not enabled.');
+ }
+ }
+
+ public function testRateLimitEnforced()
+ {
+ $data = $this->createTable();
+ $databaseId = $data['databaseId'];
+ $tableId = $data['tableId'];
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$CREATE_ROW);
+ $max = 120;
+
+ for ($i = 0; $i <= $max + 1; $i++) {
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $databaseId,
+ 'tableId' => $tableId,
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'name' => 'John Doe',
+ ],
+ ],
+ ];
+
+ $response = $this->client->call(Client::METHOD_POST, '/graphql', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $gqlPayload);
+
+ if ($i < $max) {
+ $this->assertArrayNotHasKey('errors', $response['body']);
+ } else {
+ $this->assertArrayHasKey('errors', $response['body']);
+ }
+ }
+ }
+
+ public function testComplexQueryBlocked()
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$COMPLEX_QUERY_TABLE);
+ $graphQLPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'userId' => 'user',
+ 'email' => 'user@appwrite.io',
+ 'password' => 'password',
+ 'databaseId' => 'database',
+ 'databaseName' => 'database',
+ 'tableId' => 'table',
+ 'tableName' => 'table',
+ 'tablePermissions' => [
+ Permission::read(Role::users()),
+ Permission::create(Role::users()),
+ Permission::update(Role::users()),
+ Permission::delete(Role::users()),
+ ],
+ 'rowSecurity' => false,
+ ],
+ ];
+
+ $response = $this->client->call(Client::METHOD_POST, '/graphql', \array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $graphQLPayload);
+
+ $max = System::getEnv('_APP_GRAPHQL_MAX_QUERY_COMPLEXITY', 250);
+
+ $this->assertEquals('Max query complexity should be ' . $max . ' but got 259.', $response['body']['errors'][0]['message']);
+ }
+
+ public function testTooManyQueriesBlocked()
+ {
+ $projectId = $this->getProject()['$id'];
+ $maxQueries = System::getEnv('_APP_GRAPHQL_MAX_QUERIES', 10);
+
+ $query = [];
+ for ($i = 0; $i <= $maxQueries + 1; $i++) {
+ $query[] = ['query' => $this->getQuery(self::$LIST_COUNTRIES)];
+ }
+
+ $response = $this->client->call(Client::METHOD_POST, '/graphql', \array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $query);
+
+ $this->assertEquals('Too many queries.', $response['body']['message']);
+ }
+
+ private function createTable(): array
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$CREATE_DATABASE);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => 'actors',
+ 'name' => 'AbuseDatabase',
+ ]
+ ];
+
+ $response = $this->client->call(Client::METHOD_POST, '/graphql', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ], $gqlPayload);
+
+ $databaseId = $response['body']['data']['databasesCreate']['_id'];
+
+ $query = $this->getQuery(self::$CREATE_TABLE);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $databaseId,
+ 'tableId' => 'actors',
+ 'name' => 'Actors',
+ 'rowSecurity' => false,
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::write(Role::any()),
+ ],
+ ]
+ ];
+
+ $response = $this->client->call(Client::METHOD_POST, '/graphql', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ], $gqlPayload);
+
+ $tableId = $response['body']['data']['tablesCreate']['_id'];
+
+ $query = $this->getQuery(self::$CREATE_STRING_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $databaseId,
+ 'tableId' => $tableId,
+ 'key' => 'name',
+ 'size' => 256,
+ 'required' => true,
+ ]
+ ];
+
+ $this->client->call(Client::METHOD_POST, '/graphql', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ], $gqlPayload);
+
+ sleep(2);
+
+ return [
+ 'databaseId' => $databaseId,
+ 'tableId' => $tableId,
+ ];
+ }
+}
diff --git a/tests/e2e/Services/GraphQL/Tables/AuthTest.php b/tests/e2e/Services/GraphQL/Tables/AuthTest.php
new file mode 100644
index 0000000000..21d581d207
--- /dev/null
+++ b/tests/e2e/Services/GraphQL/Tables/AuthTest.php
@@ -0,0 +1,253 @@
+getProject()['$id'];
+ $query = $this->getQuery(self::$CREATE_ACCOUNT);
+
+ $email1 = 'test' . \rand() . '@test.com';
+ $email2 = 'test' . \rand() . '@test.com';
+
+ // Create account 1
+ $graphQLPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'userId' => ID::unique(),
+ 'name' => 'User Name',
+ 'email' => $email1,
+ 'password' => 'password',
+ ],
+ ];
+ $this->account1 = $this->client->call(Client::METHOD_POST, '/graphql', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $graphQLPayload);
+
+ // Create account 2
+ $graphQLPayload['variables']['userId'] = ID::unique();
+ $graphQLPayload['variables']['email'] = $email2;
+
+ $this->client->call(Client::METHOD_POST, '/graphql', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $graphQLPayload);
+
+ // Create session 1
+ $query = $this->getQuery(self::$CREATE_ACCOUNT_SESSION);
+ $graphQLPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'email' => $email1,
+ 'password' => 'password',
+ ]
+ ];
+ $session1 = $this->client->call(Client::METHOD_POST, '/graphql', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $graphQLPayload);
+
+ $this->token1 = $session1['cookies']['a_session_' . $projectId];
+
+ // Create session 2
+ $graphQLPayload['variables']['email'] = $email2;
+
+ $session2 = $this->client->call(Client::METHOD_POST, '/graphql', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $graphQLPayload);
+
+ $this->token2 = $session2['cookies']['a_session_' . $projectId];
+
+ // Create database
+ $query = $this->getQuery(self::$CREATE_DATABASE);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => ID::unique(),
+ 'name' => 'Actors',
+ ]
+ ];
+ $this->database = $this->client->call(Client::METHOD_POST, '/graphql', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ], $gqlPayload);
+
+ // Create table
+ $query = $this->getQuery(self::$CREATE_TABLE);
+ $userId = $this->account1['body']['data']['accountCreate']['_id'];
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $this->database['body']['data']['databasesCreate']['_id'],
+ 'tableId' => ID::unique(),
+ 'name' => 'Actors',
+ 'rowSecurity' => true,
+ 'permissions' => [
+ Permission::create(Role::user($userId))
+ ]
+ ]
+ ];
+ $this->table = $this->client->call(Client::METHOD_POST, '/graphql', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ], $gqlPayload);
+
+ // Create string attribute
+ $query = $this->getQuery(self::$CREATE_STRING_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $this->database['body']['data']['databasesCreate']['_id'],
+ 'tableId' => $this->table['body']['data']['tablesCreate']['_id'],
+ 'key' => 'name',
+ 'size' => 256,
+ 'required' => true,
+ ]
+ ];
+ $this->client->call(Client::METHOD_POST, '/graphql', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ], $gqlPayload);
+
+ sleep(1);
+ }
+
+ public function testInvalidAuth()
+ {
+ $projectId = $this->getProject()['$id'];
+
+ // Create row as account 1
+ $query = $this->getQuery(self::$CREATE_ROW);
+ $userId = $this->account1['body']['data']['accountCreate']['_id'];
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $this->database['body']['data']['databasesCreate']['_id'],
+ 'tableId' => $this->table['body']['data']['tablesCreate']['_id'],
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'name' => 'John Doe',
+ ],
+ 'permissions' => [
+ Permission::read(Role::user($userId)),
+ Permission::update(Role::user($userId)),
+ Permission::delete(Role::user($userId)),
+ ]
+ ]
+ ];
+ $row = $this->client->call(Client::METHOD_POST, '/graphql', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ 'cookie' => 'a_session_' . $projectId . '=' . $this->token1,
+ ], $gqlPayload);
+
+ // Try to read as account 1
+ $query = $this->getQuery(self::$GET_ROW);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $this->database['body']['data']['databasesCreate']['_id'],
+ 'tableId' => $this->table['body']['data']['tablesCreate']['_id'],
+ 'rowId' => $row['body']['data']['tablesCreateRow']['_id'],
+ ]
+ ];
+ $row = $this->client->call(Client::METHOD_POST, '/graphql', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ 'cookie' => 'a_session_' . $projectId . '=' . $this->token1,
+ ], $gqlPayload);
+
+ $this->assertIsArray($row['body']['data']['tablesGetRow']);
+ $this->assertArrayNotHasKey('errors', $row['body']);
+
+ // Try to read as account 2
+ $row = $this->client->call(Client::METHOD_POST, '/graphql', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ 'cookie' => 'a_session_' . $projectId . '=' . $this->token2,
+ ], $gqlPayload);
+
+ $this->assertArrayHasKey('errors', $row['body']);
+ $this->assertEquals('Row with the requested ID could not be found.', $row['body']['errors'][0]['message']);
+ }
+
+ public function testValidAuth()
+ {
+ $projectId = $this->getProject()['$id'];
+
+ // Create row as account 1
+ $query = $this->getQuery(self::$CREATE_ROW);
+ $userId = $this->account1['body']['data']['accountCreate']['_id'];
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $this->database['body']['data']['databasesCreate']['_id'],
+ 'tableId' => $this->table['body']['data']['tablesCreate']['_id'],
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'name' => 'John Doe',
+ ],
+ 'permissions' => [
+ Permission::read(Role::user($userId)),
+ Permission::update(Role::user($userId)),
+ Permission::delete(Role::user($userId)),
+ ],
+ ]
+ ];
+ $row = $this->client->call(Client::METHOD_POST, '/graphql', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ 'cookie' => 'a_session_' . $projectId . '=' . $this->token1,
+ ], $gqlPayload);
+
+ // Try to delete as account 1
+ $query = $this->getQuery(self::$DELETE_ROW);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $this->database['body']['data']['databasesCreate']['_id'],
+ 'tableId' => $this->table['body']['data']['tablesCreate']['_id'],
+ 'rowId' => $row['body']['data']['tablesCreateRow']['_id'],
+ ]
+ ];
+ $row = $this->client->call(Client::METHOD_POST, '/graphql', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ 'cookie' => 'a_session_' . $projectId . '=' . $this->token1,
+ ], $gqlPayload);
+
+ $this->assertIsNotArray($row['body']);
+ $this->assertEquals(204, $row['headers']['status-code']);
+ }
+}
diff --git a/tests/e2e/Services/GraphQL/Tables/DatabaseClientTest.php b/tests/e2e/Services/GraphQL/Tables/DatabaseClientTest.php
new file mode 100644
index 0000000000..5ff8e65922
--- /dev/null
+++ b/tests/e2e/Services/GraphQL/Tables/DatabaseClientTest.php
@@ -0,0 +1,589 @@
+getProject()['$id'];
+ $query = $this->getQuery(self::$CREATE_DATABASE);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => ID::unique(),
+ 'name' => 'Actors',
+ ]
+ ];
+
+ $database = $this->client->call(Client::METHOD_POST, '/graphql', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ], $gqlPayload);
+
+ $this->assertIsArray($database['body']['data']);
+ $this->assertArrayNotHasKey('errors', $database['body']);
+ $database = $database['body']['data']['databasesCreate'];
+ $this->assertEquals('Actors', $database['name']);
+
+ return $database;
+ }
+
+ /**
+ * @depends testCreateDatabase
+ */
+ public function testCreateTable($database): array
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$CREATE_TABLE);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $database['_id'],
+ 'tableId' => 'actors',
+ 'name' => 'Actors',
+ 'rowSecurity' => false,
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::create(Role::users()),
+ Permission::update(Role::users()),
+ Permission::delete(Role::users()),
+ ],
+ ]
+ ];
+
+ $table = $this->client->call(Client::METHOD_POST, '/graphql', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ], $gqlPayload);
+
+ $this->assertIsArray($table['body']['data']);
+ $this->assertArrayNotHasKey('errors', $table['body']);
+ $table = $table['body']['data']['tablesCreate'];
+ $this->assertEquals('Actors', $table['name']);
+
+ return [
+ 'table' => $table,
+ 'database' => $database,
+ ];
+ }
+
+ /**
+ * @depends testCreateTable
+ */
+ public function testCreateStringColumn($data): array
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$CREATE_STRING_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'key' => 'name',
+ 'size' => 256,
+ 'required' => true,
+ ]
+ ];
+
+ $column = $this->client->call(Client::METHOD_POST, '/graphql', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ], $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $column['body']);
+ $this->assertIsArray($column['body']['data']);
+ $this->assertIsArray($column['body']['data']['tablesCreateStringColumn']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateTable
+ */
+ public function testCreateIntegerColumn($data): array
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$CREATE_INTEGER_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'key' => 'age',
+ 'min' => 18,
+ 'max' => 150,
+ 'required' => true,
+ ]
+ ];
+
+ $column = $this->client->call(Client::METHOD_POST, '/graphql', [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ], $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $column['body']);
+ $this->assertIsArray($column['body']['data']);
+ $this->assertIsArray($column['body']['data']['tablesCreateIntegerColumn']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateStringColumn
+ * @depends testCreateIntegerColumn
+ */
+ public function testCreateRow($data): array
+ {
+ sleep(1);
+
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$CREATE_ROW);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'name' => 'John Doe',
+ 'age' => 35,
+ ],
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ ]
+ ];
+
+ $row = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $row['body']);
+ $this->assertIsArray($row['body']['data']);
+
+ $row = $row['body']['data']['tablesCreateRow'];
+ $this->assertIsArray($row);
+
+ return [
+ 'database' => $data['database'],
+ 'table' => $data['table'],
+ 'row' => $row,
+ ];
+ }
+
+ /**
+ * @depends testCreateTable
+ * @throws \Exception
+ */
+ public function testGetRows($data): void
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$GET_ROWS);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ ]
+ ];
+
+ $rows = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $rows['body']);
+ $this->assertIsArray($rows['body']['data']);
+ $this->assertIsArray($rows['body']['data']['tablesListRows']);
+ }
+
+ /**
+ * @depends testCreateRow
+ * @throws \Exception
+ */
+ public function testGetDocument($data): void
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$GET_ROW);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'rowId' => $data['row']['_id'],
+ ]
+ ];
+
+ $row = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $row['body']);
+ $this->assertIsArray($row['body']['data']);
+ $this->assertIsArray($row['body']['data']['tablesGetRow']);
+ }
+
+ /**
+ * @depends testCreateRow
+ * @throws \Exception
+ */
+ public function testUpdateRow($data): void
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$UPDATE_ROW);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'rowId' => $data['row']['_id'],
+ 'data' => [
+ 'name' => 'New Row Name',
+ ],
+ ]
+ ];
+
+ $row = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $row['body']);
+ $this->assertIsArray($row['body']['data']);
+ $row = $row['body']['data']['tablesUpdateRow'];
+ $this->assertIsArray($row);
+
+ $this->assertStringContainsString('New Row Name', $row['data']);
+ }
+
+ /**
+ * @depends testCreateRow
+ * @throws \Exception
+ */
+ public function testDeleteRow($data): void
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$DELETE_ROW);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'rowId' => $data['row']['_id'],
+ ]
+ ];
+
+ $row = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertIsNotArray($row['body']);
+ $this->assertEquals(204, $row['headers']['status-code']);
+ }
+
+ /**
+ * @throws \Exception
+ */
+ public function testBulkCreate(): array
+ {
+ $project = $this->getProject();
+ $projectId = $project['$id'];
+ $headers = [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ 'x-appwrite-key' => $project['apiKey'],
+ ];
+
+ // Step 1: Create database
+ $query = $this->getQuery(self::$CREATE_DATABASE);
+ $payload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => 'bulk',
+ 'name' => 'Bulk',
+ ],
+ ];
+
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+ $databaseId = $res['body']['data']['databasesCreate']['_id'];
+
+ // Step 2: Create table
+ $query = $this->getQuery(self::$CREATE_TABLE);
+ $payload['query'] = $query;
+ $payload['variables'] = [
+ 'databaseId' => $databaseId,
+ 'tableId' => 'operations',
+ 'name' => 'Operations',
+ 'rowSecurity' => false,
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ ];
+
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+ $tableId = $res['body']['data']['tablesCreate']['_id'];
+
+ // Step 3: Create column
+ $query = $this->getQuery(self::$CREATE_STRING_COLUMN);
+ $payload['query'] = $query;
+ $payload['variables'] = [
+ 'databaseId' => $databaseId,
+ 'tableId' => $tableId,
+ 'key' => 'name',
+ 'size' => 256,
+ 'required' => true,
+ ];
+
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+ sleep(1);
+
+ // Step 4: Create rows
+ $query = $this->getQuery(self::$CREATE_ROWS);
+ $rows = [];
+ for ($i = 1; $i <= 10; $i++) {
+ $rows[] = ['$id' => 'row' . $i, 'name' => 'Row #' . $i];
+ }
+
+ $payload['query'] = $query;
+ $payload['variables'] = [
+ 'databaseId' => $databaseId,
+ 'tableId' => $tableId,
+ 'rows' => $rows,
+ ];
+
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+ $this->assertCount(10, $res['body']['data']['tablesCreateRows']['rows']);
+
+ return compact('databaseId', 'tableId', 'projectId');
+ }
+
+ /**
+ * @depends testBulkCreate
+ */
+ public function testBulkUpdate(array $data): array
+ {
+ $userId = $this->getUser()['$id'];
+ $permissions = [
+ Permission::read(Role::user($userId)),
+ Permission::update(Role::user($userId)),
+ Permission::delete(Role::user($userId)),
+ ];
+
+ $headers = [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $data['projectId'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ];
+
+ // Step 1: Bulk update rows
+ $query = $this->getQuery(self::$UPDATE_ROWS);
+ $payload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['databaseId'],
+ 'tableId' => $data['tableId'],
+ 'data' => [
+ 'name' => 'Rows Updated',
+ '$permissions' => $permissions,
+ ],
+ ],
+ ];
+
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+ $this->assertCount(10, $res['body']['data']['tablesUpdateRows']['rows']);
+
+ // Step 2: Fetch and validate updated rows
+ $query = $this->getQuery(self::$GET_ROWS);
+ $payload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['databaseId'],
+ 'tableId' => $data['tableId'],
+ 'queries' => [Query::equal('name', ['Rows Updated'])->toString()],
+ ],
+ ];
+
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertEquals(200, $res['headers']['status-code']);
+
+ $fetched = $res['body']['data']['tablesListRows'];
+ $this->assertEquals(10, $fetched['total']);
+
+ foreach ($fetched['rows'] as $row) {
+ $this->assertEquals($permissions, $row['_permissions']);
+ $this->assertEquals($data['tableId'], $row['_tableId']);
+ $this->assertEquals($data['databaseId'], $row['_databaseId']);
+ $this->assertEquals('Rows Updated', json_decode($row['data'], true)['name']);
+ }
+
+ return $data;
+ }
+
+ /**
+ * @depends testBulkCreate
+ */
+ public function testBulkUpsert(array $data): array
+ {
+ $userId = $this->getUser()['$id'];
+ $headers = [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $data['projectId'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ];
+
+ $permissions = [
+ Permission::read(Role::user($userId)),
+ Permission::update(Role::user($userId)),
+ Permission::delete(Role::user($userId)),
+ ];
+
+ // Step 1: Mutate row 10 and add row 11
+ $query = $this->getQuery(self::$UPSERT_ROWS);
+ $upsertPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['databaseId'],
+ 'tableId' => $data['tableId'],
+ 'rows' => [
+ [
+ '$id' => 'row10',
+ 'name' => 'Row #1000',
+ ],
+ [
+ 'name' => 'Row #11',
+ ],
+ ],
+ ],
+ ];
+
+ $response = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $upsertPayload);
+ $this->assertArrayNotHasKey('errors', $response['body']);
+
+ $rows = $response['body']['data']['tablesUpsertRows']['rows'];
+ $this->assertCount(2, $rows);
+
+ $rowMap = [];
+ foreach ($rows as $row) {
+ $decoded = json_decode($row['data'], true);
+ $rowMap[$decoded['name']] = $decoded;
+ }
+
+ $this->assertArrayHasKey('Row #1000', $rowMap);
+ $this->assertArrayHasKey('Row #11', $rowMap);
+
+ // Step 2: Fetch all rows and confirm count is now 11
+ $query = $this->getQuery(self::$GET_ROWS);
+ $fetchPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['databaseId'],
+ 'tableId' => $data['tableId'],
+ ],
+ ];
+
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $fetchPayload);
+ $this->assertEquals(200, $res['headers']['status-code']);
+
+ $fetched = $res['body']['data']['tablesListRows'];
+ $this->assertEquals(11, $fetched['total']);
+
+ // Step 3: Upsert row with new permissions using `tablesUpsertRow`
+ $query = $this->getQuery(self::$UPSERT_ROW);
+ $payload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['databaseId'],
+ 'tableId' => $data['tableId'],
+ 'rowId' => 'row10',
+ 'data' => ['name' => 'Row #10 Patched'],
+ 'permissions' => $permissions,
+ ],
+ ];
+
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+
+ $updated = $res['body']['data']['tablesUpsertRow'];
+ $this->assertEquals('Row #10 Patched', json_decode($updated['data'], true)['name']);
+ $this->assertEquals($data['databaseId'], $updated['_databaseId']);
+ $this->assertEquals($data['tableId'], $updated['_tableId']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testBulkUpsert
+ */
+ public function testBulkDelete(array $data): array
+ {
+ $headers = [
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $data['projectId'],
+ 'x-appwrite-key' => $this->getProject()['apiKey'],
+ ];
+
+ // Step 1: Perform bulk delete
+ $query = $this->getQuery(self::$DELETE_ROWS);
+ $payload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['databaseId'],
+ 'tableId' => $data['tableId'],
+ ],
+ ];
+
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+
+ $deleted = $res['body']['data']['tablesDeleteRows']['rows'];
+ $this->assertIsArray($deleted);
+ $this->assertCount(11, $deleted);
+
+ // Step 2: Confirm deletion via refetch
+ $query = $this->getQuery(self::$GET_ROWS);
+ $payload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['databaseId'],
+ 'tableId' => $data['tableId'],
+ ],
+ ];
+
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertEquals(200, $res['headers']['status-code']);
+ $this->assertEquals(0, $res['body']['data']['tablesListRows']['total']);
+
+ return $data;
+ }
+}
diff --git a/tests/e2e/Services/GraphQL/Tables/DatabaseServerTest.php b/tests/e2e/Services/GraphQL/Tables/DatabaseServerTest.php
new file mode 100644
index 0000000000..e4e9b34f35
--- /dev/null
+++ b/tests/e2e/Services/GraphQL/Tables/DatabaseServerTest.php
@@ -0,0 +1,1747 @@
+getProject()['$id'];
+ $query = $this->getQuery(self::$CREATE_DATABASE);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => 'actors',
+ 'name' => 'Actors',
+ ]
+ ];
+
+ $database = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertIsArray($database['body']['data']);
+ $this->assertArrayNotHasKey('errors', $database['body']);
+ $database = $database['body']['data']['databasesCreate'];
+ $this->assertEquals('Actors', $database['name']);
+
+ return $database;
+ }
+
+ /**
+ * @depends testCreateDatabase
+ */
+ public function testCreateTable($database): array
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$CREATE_TABLE);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $database['_id'],
+ 'tableId' => 'actors',
+ 'name' => 'Actors',
+ 'rowSecurity' => false,
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::create(Role::users()),
+ Permission::update(Role::users()),
+ Permission::delete(Role::users()),
+ ],
+ ]
+ ];
+
+ $table = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertIsArray($table['body']['data']);
+ $this->assertArrayNotHasKey('errors', $table['body']);
+ $table = $table['body']['data']['tablesCreate'];
+ $this->assertEquals('Actors', $table['name']);
+
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $database['_id'],
+ 'tableId' => 'movies',
+ 'name' => 'Movies',
+ 'rowSecurity' => false,
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::create(Role::users()),
+ Permission::update(Role::users()),
+ Permission::delete(Role::users()),
+ ],
+ ]
+ ];
+
+ $table2 = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertIsArray($table2['body']['data']);
+ $this->assertArrayNotHasKey('errors', $table2['body']);
+ $table2 = $table2['body']['data']['tablesCreate'];
+ $this->assertEquals('Movies', $table2['name']);
+
+ return [
+ 'database' => $database,
+ 'table' => $table,
+ 'table2' => $table2,
+ ];
+ }
+
+ /**
+ * @depends testCreateTable
+ * @throws Exception
+ */
+ public function testCreateStringColumn($data): array
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$CREATE_STRING_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'key' => 'name',
+ 'size' => 256,
+ 'required' => true,
+ ]
+ ];
+
+ $column = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ // TODO: @itznotabug - check for `encrypt` attribute in string column's response body as well!
+ $this->assertArrayNotHasKey('errors', $column['body']);
+ $this->assertIsArray($column['body']['data']);
+ $this->assertIsArray($column['body']['data']['tablesCreateStringColumn']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateStringColumn
+ * @throws Exception
+ */
+ public function testUpdateStringColumn($data): array
+ {
+ // Wait for columns to be available
+ sleep(1);
+
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$UPDATE_STRING_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'key' => 'name',
+ 'required' => false,
+ 'default' => 'Default Value',
+ ]
+ ];
+
+ $column = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertIsArray($column['body']['data']);
+ $this->assertIsArray($column['body']['data']['tablesUpdateStringColumn']);
+ $this->assertFalse($column['body']['data']['tablesUpdateStringColumn']['required']);
+ $this->assertEquals('Default Value', $column['body']['data']['tablesUpdateStringColumn']['default']);
+ $this->assertEquals(200, $column['headers']['status-code']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateTable
+ * @throws Exception
+ */
+ public function testCreateIntegerColumn($data): array
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$CREATE_INTEGER_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'key' => 'age',
+ 'min' => 18,
+ 'max' => 150,
+ 'required' => true,
+ ]
+ ];
+
+ $column = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $column['body']);
+ $this->assertIsArray($column['body']['data']);
+ $this->assertIsArray($column['body']['data']['tablesCreateIntegerColumn']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateIntegerColumn
+ * @throws Exception
+ */
+ public function testUpdateIntegerColumn($data): array
+ {
+ // Wait for columns to be available
+ sleep(1);
+
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$UPDATE_INTEGER_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'key' => 'age',
+ 'required' => false,
+ 'min' => 12,
+ 'max' => 160,
+ 'default' => 50
+ ]
+ ];
+
+ $column = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertIsArray($column['body']['data']);
+ $this->assertIsArray($column['body']['data']['tablesUpdateIntegerColumn']);
+ $this->assertFalse($column['body']['data']['tablesUpdateIntegerColumn']['required']);
+ $this->assertEquals(12, $column['body']['data']['tablesUpdateIntegerColumn']['min']);
+ $this->assertEquals(160, $column['body']['data']['tablesUpdateIntegerColumn']['max']);
+ $this->assertEquals(50, $column['body']['data']['tablesUpdateIntegerColumn']['default']);
+ $this->assertEquals(200, $column['headers']['status-code']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateTable
+ * @throws Exception
+ */
+ public function testCreateBooleanColumn($data): array
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$CREATE_BOOLEAN_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'key' => 'alive',
+ 'required' => true,
+ ]
+ ];
+
+ $column = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $column['body']);
+ $this->assertIsArray($column['body']['data']);
+ $this->assertIsArray($column['body']['data']['tablesCreateBooleanColumn']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateBooleanColumn
+ * @throws Exception
+ */
+ public function testUpdateBooleanColumn($data): array
+ {
+ // Wait for columns to be available
+ sleep(1);
+
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$UPDATE_BOOLEAN_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'key' => 'alive',
+ 'required' => false,
+ 'default' => true
+ ]
+ ];
+
+ $column = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertIsArray($column['body']['data']);
+ $this->assertIsArray($column['body']['data']['tablesUpdateBooleanColumn']);
+ $this->assertFalse($column['body']['data']['tablesUpdateBooleanColumn']['required']);
+ $this->assertTrue($column['body']['data']['tablesUpdateBooleanColumn']['default']);
+ $this->assertEquals(200, $column['headers']['status-code']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateTable
+ * @throws Exception
+ */
+ public function testCreateFloatColumn($data): array
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$CREATE_FLOAT_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'key' => 'salary',
+ 'min' => 1000.0,
+ 'max' => 999999.99,
+ 'default' => 1000.0,
+ 'required' => false,
+ ]
+ ];
+
+ $column = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $column['body']);
+ $this->assertIsArray($column['body']['data']);
+ $this->assertIsArray($column['body']['data']['tablesCreateFloatColumn']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateFloatColumn
+ * @throws Exception
+ */
+ public function testUpdateFloatColumn($data): array
+ {
+ // Wait for columns to be available
+ sleep(1);
+
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$UPDATE_FLOAT_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'key' => 'salary',
+ 'required' => false,
+ 'min' => 100.0,
+ 'max' => 1000000.0,
+ 'default' => 2500.0
+ ]
+ ];
+
+ $column = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertIsArray($column['body']['data']);
+ $this->assertIsArray($column['body']['data']['tablesUpdateFloatColumn']);
+ $this->assertFalse($column['body']['data']['tablesUpdateFloatColumn']['required']);
+ $this->assertEquals(100.0, $column['body']['data']['tablesUpdateFloatColumn']['min']);
+ $this->assertEquals(1000000.0, $column['body']['data']['tablesUpdateFloatColumn']['max']);
+ $this->assertEquals(2500.0, $column['body']['data']['tablesUpdateFloatColumn']['default']);
+ $this->assertEquals(200, $column['headers']['status-code']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateTable
+ * @throws Exception
+ */
+ public function testCreateEmailColumn($data): array
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$CREATE_EMAIL_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'key' => 'email',
+ 'required' => true,
+ ]
+ ];
+
+ $column = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $column['body']);
+ $this->assertIsArray($column['body']['data']);
+ $this->assertIsArray($column['body']['data']['tablesCreateEmailColumn']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateEmailColumn
+ * @throws Exception
+ */
+ public function testUpdateEmailColumn($data): array
+ {
+ // Wait for columns to be available
+ sleep(1);
+
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$UPDATE_EMAIL_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'key' => 'email',
+ 'required' => false,
+ 'default' => 'torsten@appwrite.io',
+ ]
+ ];
+
+ $column = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertIsArray($column['body']['data']);
+ $this->assertIsArray($column['body']['data']['tablesUpdateEmailColumn']);
+ $this->assertFalse($column['body']['data']['tablesUpdateEmailColumn']['required']);
+ $this->assertEquals('torsten@appwrite.io', $column['body']['data']['tablesUpdateEmailColumn']['default']);
+ $this->assertEquals(200, $column['headers']['status-code']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateTable
+ * @throws Exception
+ */
+ public function testCreateEnumColumn($data): array
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$CREATE_ENUM_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'key' => 'role',
+ 'elements' => [
+ 'crew',
+ 'actor',
+ 'guest',
+ ],
+ 'required' => true,
+ ]
+ ];
+
+ $column = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $column['body']);
+ $this->assertIsArray($column['body']['data']);
+ $this->assertIsArray($column['body']['data']['tablesCreateEnumColumn']);
+
+ return $data;
+ }
+
+
+ /**
+ * @depends testCreateEnumColumn
+ * @throws Exception
+ */
+ public function testUpdateEnumColumn($data): array
+ {
+ // Wait for columns to be available
+ sleep(1);
+
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$UPDATE_ENUM_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'key' => 'role',
+ 'required' => false,
+ 'elements' => [
+ 'crew',
+ 'tech',
+ 'actor'
+ ],
+ 'default' => 'tech'
+ ]
+ ];
+
+ $column = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertIsArray($column['body']['data']);
+ $this->assertIsArray($column['body']['data']['tablesUpdateEnumColumn']);
+ $this->assertFalse($column['body']['data']['tablesUpdateEnumColumn']['required']);
+ $this->assertEquals('tech', $column['body']['data']['tablesUpdateEnumColumn']['default']);
+ $this->assertContains('tech', $column['body']['data']['tablesUpdateEnumColumn']['elements']);
+ $this->assertNotContains('guest', $column['body']['data']['tablesUpdateEnumColumn']['elements']);
+ $this->assertEquals(200, $column['headers']['status-code']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateTable
+ * @throws Exception
+ */
+ public function testCreateDatetimeColumn($data): array
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$CREATE_DATETIME_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'key' => 'dob',
+ 'required' => true,
+ ]
+ ];
+
+ $column = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $column['body']);
+ $this->assertIsArray($column['body']['data']);
+ $this->assertIsArray($column['body']['data']['tablesCreateDatetimeColumn']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateDatetimeColumn
+ * @throws Exception
+ */
+ public function testUpdateDatetimeColumn($data): array
+ {
+ // Wait for columns to be available
+ sleep(1);
+
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$UPDATE_DATETIME_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'key' => 'dob',
+ 'required' => false,
+ 'default' => '2000-01-01T00:00:00Z'
+ ]
+ ];
+
+ $column = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertIsArray($column['body']['data']);
+ $this->assertIsArray($column['body']['data']['tablesUpdateDatetimeColumn']);
+ $this->assertFalse($column['body']['data']['tablesUpdateDatetimeColumn']['required']);
+ $this->assertEquals('2000-01-01T00:00:00Z', $column['body']['data']['tablesUpdateDatetimeColumn']['default']);
+ $this->assertEquals(200, $column['headers']['status-code']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateTable
+ */
+ public function testCreateRelationshipColumn(array $data): array
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$CREATE_RELATIONSHIP_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table2']['_id'], // Movies
+ 'relatedTableId' => $data['table']['_id'], // Actors
+ 'type' => Database::RELATION_ONE_TO_MANY,
+ 'twoWay' => true,
+ 'key' => 'actors',
+ 'twoWayKey' => 'movie'
+ ]
+ ];
+
+ $column = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $column['body']);
+ $this->assertIsArray($column['body']['data']);
+ $this->assertIsArray($column['body']['data']['tablesCreateRelationshipColumn']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateRelationshipColumn
+ */
+ public function testUpdateRelationshipColumn(array $data): array
+ {
+ sleep(1);
+
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$UPDATE_RELATIONSHIP_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table2']['_id'],
+ 'key' => 'actors',
+ 'onDelete' => Database::RELATION_MUTATE_CASCADE,
+ ]
+ ];
+
+ $column = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $column['body']);
+ $this->assertIsArray($column['body']['data']);
+ $this->assertIsArray($column['body']['data']['tablesUpdateRelationshipColumn']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateTable
+ * @throws Exception
+ */
+ public function testCreateIPColumn($data): array
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$CREATE_IP_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'key' => 'ip',
+ 'required' => false,
+ 'default' => '::1',
+ ]
+ ];
+
+ $column = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $column['body']);
+ $this->assertIsArray($column['body']['data']);
+ $this->assertIsArray($column['body']['data']['tablesCreateIpColumn']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateIPColumn
+ * @throws Exception
+ */
+ public function testUpdateIPColumn($data): array
+ {
+ // Wait for columns to be available
+ sleep(3);
+
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$UPDATE_IP_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'key' => 'ip',
+ 'required' => false,
+ 'default' => '127.0.0.1'
+ ]
+ ];
+
+ $column = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertIsArray($column['body']['data']);
+ $this->assertIsArray($column['body']['data']['tablesUpdateIpColumn']);
+ $this->assertFalse($column['body']['data']['tablesUpdateIpColumn']['required']);
+ $this->assertEquals('127.0.0.1', $column['body']['data']['tablesUpdateIpColumn']['default']);
+ $this->assertEquals(200, $column['headers']['status-code']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateTable
+ * @throws Exception
+ */
+ public function testCreateURLColumn($data): array
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$CREATE_URL_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'key' => 'url',
+ 'required' => false,
+ 'default' => 'https://appwrite.io',
+ ]
+ ];
+
+ $column = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $column['body']);
+ $this->assertIsArray($column['body']['data']);
+ $this->assertIsArray($column['body']['data']['tablesCreateUrlColumn']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateURLColumn
+ * @throws Exception
+ */
+ public function testUpdateURLColumn($data): void
+ {
+ // Wait for columns to be available
+ sleep(3);
+
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$UPDATE_URL_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'key' => 'url',
+ 'required' => false,
+ 'default' => 'https://cloud.appwrite.io'
+ ]
+ ];
+
+ $column = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertIsArray($column['body']['data']);
+ $this->assertIsArray($column['body']['data']['tablesUpdateUrlColumn']);
+ $this->assertFalse($column['body']['data']['tablesUpdateUrlColumn']['required']);
+ $this->assertEquals('https://cloud.appwrite.io', $column['body']['data']['tablesUpdateUrlColumn']['default']);
+ $this->assertEquals(200, $column['headers']['status-code']);
+ }
+
+ /**
+ * @depends testUpdateStringColumn
+ * @depends testUpdateIntegerColumn
+ * @throws Exception
+ */
+ public function testCreateIndex($data): array
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$CREATE_COLUMN_INDEX);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'key' => 'index',
+ 'type' => 'key',
+ 'columns' => [
+ 'name',
+ 'age',
+ ],
+ ]
+ ];
+
+ $index = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $index['body']);
+ $this->assertIsArray($index['body']['data']);
+ $this->assertIsArray($index['body']['data']['tablesCreateIndex']);
+
+ return [
+ 'database' => $data['database'],
+ 'table' => $data['table'],
+ 'index' => $index['body']['data']['tablesCreateIndex'],
+ ];
+ }
+
+ /**
+ * @depends testUpdateStringColumn
+ * @depends testUpdateIntegerColumn
+ * @depends testUpdateBooleanColumn
+ * @depends testUpdateEnumColumn
+ * @throws Exception
+ */
+ public function testCreateRow($data): array
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$CREATE_ROW);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'name' => 'John Doe',
+ 'email' => 'example@appwrite.io',
+ 'age' => 30,
+ 'alive' => true,
+ 'salary' => 9999.9,
+ 'role' => 'crew',
+ 'dob' => '2000-01-01T00:00:00Z',
+ ],
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ ]
+ ];
+
+ $row = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $row['body']);
+ $this->assertIsArray($row['body']['data']);
+
+ $row = $row['body']['data']['tablesCreateRow'];
+ $this->assertIsArray($row);
+
+ return [
+ 'database' => $data['database'],
+ 'table' => $data['table'],
+ 'row' => $row,
+ ];
+ }
+
+ // /**
+ // * @depends testCreateStringColumn
+ // * @depends testCreateIntegerColumn
+ // * @depends testCreateBooleanColumn
+ // * @depends testCreateFloatColumn
+ // * @depends testCreateEmailColumn
+ // * @depends testCreateEnumColumn
+ // * @depends testCreateDatetimeColumn
+ // * @throws Exception
+ // */
+ // public function testCreateCustomEntity(): array
+ // {
+ // $projectId = $this->getProject()['$id'];
+ // $query = $this->getQuery(self::$CREATE_CUSTOM_ENTITY);
+ // $gqlPayload = [
+ // 'query' => $query,
+ // 'variables' => [
+ // 'name' => 'John Doe',
+ // 'age' => 35,
+ // 'alive' => true,
+ // 'salary' => 9999.9,
+ // 'email' => 'johndoe@appwrite.io',
+ // 'role' => 'crew',
+ // 'dob' => '2000-01-01T00:00:00Z',
+ // ]
+ // ];
+ //
+ // $actor = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ // 'content-type' => 'application/json',
+ // 'x-appwrite-project' => $projectId,
+ // ], $this->getHeaders()), $gqlPayload);
+ //
+ // $this->assertArrayNotHasKey('errors', $actor['body']);
+ // $this->assertIsArray($actor['body']['data']);
+ // $actor = $actor['body']['data']['actorsCreate'];
+ // $this->assertIsArray($actor);
+ //
+ // return $actor;
+ // }
+
+ public function testGetDatabases(): void
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$GET_DATABASES);
+ $gqlPayload = [
+ 'query' => $query,
+ ];
+
+ $databases = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $databases['body']);
+ $this->assertIsArray($databases['body']['data']);
+ $this->assertIsArray($databases['body']['data']['databasesList']);
+ }
+
+ /**
+ * @depends testCreateDatabase
+ * @throws Exception
+ */
+ public function testGetDatabase($database): void
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$GET_DATABASE);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $database['_id'],
+ ]
+ ];
+
+ $database = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $database['body']);
+ $this->assertIsArray($database['body']['data']);
+ $this->assertIsArray($database['body']['data']['databasesGet']);
+ }
+
+ /**
+ * @depends testCreateTable
+ * @throws Exception
+ */
+ public function testGetTables($data): void
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$GET_TABLES);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ ]
+ ];
+
+ $tables = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $tables['body']);
+ $this->assertIsArray($tables['body']['data']);
+ $this->assertIsArray($tables['body']['data']['tablesList']);
+ }
+
+ /**
+ * @depends testCreateTable
+ * @throws Exception
+ */
+ public function testGetTable($data): void
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$GET_TABLE);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ ]
+ ];
+
+ $table = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $table['body']);
+ $this->assertIsArray($table['body']['data']);
+ $this->assertIsArray($table['body']['data']['tablesGet']);
+ }
+
+ /**
+ * @depends testUpdateStringColumn
+ * @depends testUpdateIntegerColumn
+ * @throws Exception
+ */
+ public function testGetColumns($data): void
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$GET_COLUMNS);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ ]
+ ];
+
+ $columns = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $columns['body']);
+ $this->assertIsArray($columns['body']['data']);
+ $this->assertIsArray($columns['body']['data']['tablesListColumns']);
+ }
+
+ /**
+ * @depends testCreateTable
+ * @throws Exception
+ */
+ public function testGetColumn($data): void
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$GET_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'key' => 'name',
+ ]
+ ];
+
+ $column = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $column['body']);
+ $this->assertIsArray($column['body']['data']);
+ $this->assertIsArray($column['body']['data']['tablesGetColumn']);
+ }
+
+ /**
+ * @depends testCreateIndex
+ * @throws Exception
+ */
+ public function testGetIndexes($data): void
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$GET_COLUMN_INDEXES);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ ]
+ ];
+
+ $indices = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $indices['body']);
+ $this->assertIsArray($indices['body']['data']);
+ $this->assertIsArray($indices['body']['data']['tablesListIndexes']);
+ }
+
+ /**
+ * @depends testCreateIndex
+ * @throws Exception
+ */
+ public function testGetIndex($data): void
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$GET_COLUMN_INDEX);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'key' => $data['index']['key'],
+ ]
+ ];
+
+ $index = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $index['body']);
+ $this->assertIsArray($index['body']['data']);
+ $this->assertIsArray($index['body']['data']['tablesGetIndex']);
+ }
+
+ /**
+ * @depends testCreateTable
+ * @throws Exception
+ */
+ public function testGetRows($data): void
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$GET_ROWS);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ ]
+ ];
+
+ $rows = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $rows['body']);
+ $this->assertIsArray($rows['body']['data']);
+ $this->assertIsArray($rows['body']['data']['tablesListRows']);
+ }
+
+ /**
+ * @depends testCreateRow
+ * @throws Exception
+ */
+ public function testGetRow($data): void
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$GET_ROW);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'rowId' => $data['row']['_id'],
+ ]
+ ];
+
+ $row = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $row['body']);
+ $this->assertIsArray($row['body']['data']);
+ $this->assertIsArray($row['body']['data']['tablesGetRow']);
+ }
+
+ // /**
+ // * @depends testCreateCustomEntity
+ // * @throws Exception
+ // */
+ // public function testGetCustomEntities($data)
+ // {
+ // $projectId = $this->getProject()['$id'];
+ // $query = $this->getQuery(self::$GET_CUSTOM_ENTITIES);
+ // $gqlPayload = [
+ // 'query' => $query,
+ // ];
+ //
+ // $customEntities = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ // 'content-type' => 'application/json',
+ // 'x-appwrite-project' => $projectId,
+ // ], $this->getHeaders()), $gqlPayload);
+ //
+ // $this->assertArrayNotHasKey('errors', $customEntities['body']);
+ // $this->assertIsArray($customEntities['body']['data']);
+ // $this->assertIsArray($customEntities['body']['data']['actorsList']);
+ // }
+ //
+ // /**
+ // * @depends testCreateCustomEntity
+ // * @throws Exception
+ // */
+ // public function testGetCustomEntity($data)
+ // {
+ // $projectId = $this->getProject()['$id'];
+ // $query = $this->getQuery(self::$GET_CUSTOM_ENTITY);
+ // $gqlPayload = [
+ // 'query' => $query,
+ // 'variables' => [
+ // 'id' => $data['id'],
+ // ]
+ // ];
+ //
+ // $entity = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ // 'content-type' => 'application/json',
+ // 'x-appwrite-project' => $projectId,
+ // ], $this->getHeaders()), $gqlPayload);
+ //
+ // $this->assertArrayNotHasKey('errors', $entity['body']);
+ // $this->assertIsArray($entity['body']['data']);
+ // $this->assertIsArray($entity['body']['data']['actorsGet']);
+ // }
+
+ /**
+ * @depends testCreateDatabase
+ * @throws Exception
+ */
+ public function testUpdateDatabase($database)
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$UPDATE_DATABASE);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $database['_id'],
+ 'name' => 'New Database Name',
+ ]
+ ];
+
+ $database = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $database['body']);
+ $this->assertIsArray($database['body']['data']);
+ $this->assertIsArray($database['body']['data']['databasesUpdate']);
+ }
+
+ /**
+ * @depends testCreateTable
+ * @throws Exception
+ */
+ public function testUpdateTable($data)
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$UPDATE_TABLE);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'name' => 'New Table Name',
+ 'rowSecurity' => false,
+ ]
+ ];
+
+ $table = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $table['body']);
+ $this->assertIsArray($table['body']['data']);
+ $this->assertIsArray($table['body']['data']['tablesUpdate']);
+ }
+
+ /**
+ * @depends testCreateRow
+ * @throws Exception
+ */
+ public function testUpdateRow($data): void
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$UPDATE_ROW);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'rowId' => $data['row']['_id'],
+ 'data' => [
+ 'name' => 'New Row Name',
+ ],
+ ]
+ ];
+
+ $row = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertArrayNotHasKey('errors', $row['body']);
+ $this->assertIsArray($row['body']['data']);
+ $row = $row['body']['data']['tablesUpdateRow'];
+ $this->assertIsArray($row);
+ $this->assertStringContainsString('New Row Name', $row['data']);
+ }
+
+ // /**
+ // * @depends testCreateCustomEntity
+ // * @throws Exception
+ // */
+ // public function testUpdateCustomEntity(array $data)
+ // {
+ // $projectId = $this->getProject()['$id'];
+ // $query = $this->getQuery(self::$UPDATE_CUSTOM_ENTITY);
+ // $gqlPayload = [
+ // 'query' => $query,
+ // 'variables' => [
+ // 'id' => $data['id'],
+ // 'name' => 'New Custom Entity Name',
+ // ]
+ // ];
+ //
+ // $entity = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ // 'content-type' => 'application/json',
+ // 'x-appwrite-project' => $projectId,
+ // ], $this->getHeaders()), $gqlPayload);
+ //
+ // $this->assertArrayNotHasKey('errors', $entity['body']);
+ // $this->assertIsArray($entity['body']['data']);
+ // $entity = $entity['body']['data']['actorsUpdate'];
+ // $this->assertIsArray($entity);
+ // $this->assertStringContainsString('New Custom Entity Name', $entity['name']);
+ // }
+
+ /**
+ * @depends testCreateRow
+ * @throws Exception
+ */
+ public function testDeleteRow($data): void
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$DELETE_ROW);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'rowId' => $data['row']['_id'],
+ ]
+ ];
+
+ $row = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertIsNotArray($row['body']);
+ $this->assertEquals(204, $row['headers']['status-code']);
+ }
+
+ // /**
+ // * @depends testCreateCustomEntity
+ // * @throws Exception
+ // */
+ // public function testDeleteCustomEntity(array $data)
+ // {
+ // $projectId = $this->getProject()['$id'];
+ // $query = $this->getQuery(self::$DELETE_CUSTOM_ENTITY);
+ // $gqlPayload = [
+ // 'query' => $query,
+ // 'variables' => [
+ // 'id' => $data['id'],
+ // ]
+ // ];
+ //
+ // $entity = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ // 'content-type' => 'application/json',
+ // 'x-appwrite-project' => $projectId,
+ // ], $this->getHeaders()), $gqlPayload);
+ //
+ // $this->assertIsNotArray($entity['body']);
+ // $this->assertEquals(204, $entity['headers']['status-code']);
+ // }
+
+ /**
+ * @depends testUpdateStringColumn
+ * @throws Exception
+ */
+ public function testDeleteColumn($data): void
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$DELETE_COLUMN);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ 'key' => 'name',
+ ]
+ ];
+
+ $column = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertIsNotArray($column['body']);
+ $this->assertEquals(204, $column['headers']['status-code']);
+ }
+
+ /**
+ * @depends testCreateTable
+ * @throws Exception
+ */
+ public function testDeleteTable($data)
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$DELETE_TABLE);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['database']['_id'],
+ 'tableId' => $data['table']['_id'],
+ ]
+ ];
+
+ $table = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertIsNotArray($table['body']);
+ $this->assertEquals(204, $table['headers']['status-code']);
+ }
+
+ /**
+ * @depends testCreateDatabase
+ * @throws Exception
+ */
+ public function testDeleteDatabase($database)
+ {
+ $projectId = $this->getProject()['$id'];
+ $query = $this->getQuery(self::$DELETE_DATABASE);
+ $gqlPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $database['_id'],
+ ]
+ ];
+
+ $database = $this->client->call(Client::METHOD_POST, '/graphql', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders()), $gqlPayload);
+
+ $this->assertIsNotArray($database['body']);
+ $this->assertEquals(204, $database['headers']['status-code']);
+ }
+
+ /**
+ * @throws Exception
+ */
+ public function testBulkCreate(): array
+ {
+ $project = $this->getProject();
+ $projectId = $project['$id'];
+ $headers = array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $projectId,
+ ], $this->getHeaders());
+
+ // Step 1: Create database
+ $query = $this->getQuery(self::$CREATE_DATABASE);
+ $payload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => 'bulk',
+ 'name' => 'Bulk',
+ ],
+ ];
+
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+ $databaseId = $res['body']['data']['databasesCreate']['_id'];
+
+ // Step 2: Create table
+ $query = $this->getQuery(self::$CREATE_TABLE);
+ $payload['query'] = $query;
+ $payload['variables'] = [
+ 'databaseId' => $databaseId,
+ 'tableId' => 'operations',
+ 'name' => 'Operations',
+ 'rowSecurity' => false,
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ ];
+
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+ $tableId = $res['body']['data']['tablesCreate']['_id'];
+
+ // Step 3: Create column
+ $query = $this->getQuery(self::$CREATE_STRING_COLUMN);
+ $payload['query'] = $query;
+ $payload['variables'] = [
+ 'databaseId' => $databaseId,
+ 'tableId' => $tableId,
+ 'key' => 'name',
+ 'size' => 256,
+ 'required' => true,
+ ];
+
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+ sleep(1);
+
+ // Step 4: Create rows
+ $query = $this->getQuery(self::$CREATE_ROWS);
+ $rows = [];
+ for ($i = 1; $i <= 10; $i++) {
+ $rows[] = ['$id' => 'row' . $i, 'name' => 'Row #' . $i];
+ }
+
+ $payload['query'] = $query;
+ $payload['variables'] = [
+ 'databaseId' => $databaseId,
+ 'tableId' => $tableId,
+ 'rows' => $rows,
+ ];
+
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+ $this->assertCount(10, $res['body']['data']['tablesCreateRows']['rows']);
+
+ return compact('databaseId', 'tableId', 'projectId');
+ }
+
+ /**
+ * @depends testBulkCreate
+ */
+ public function testBulkUpdate(array $data): array
+ {
+ $userId = $this->getUser()['$id'];
+ $permissions = [
+ Permission::read(Role::user($userId)),
+ Permission::update(Role::user($userId)),
+ Permission::delete(Role::user($userId)),
+ ];
+
+ $headers = array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $data['projectId'],
+ ], $this->getHeaders());
+
+ // Step 1: Bulk update rows
+ $query = $this->getQuery(self::$UPDATE_ROWS);
+ $payload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['databaseId'],
+ 'tableId' => $data['tableId'],
+ 'data' => [
+ 'name' => 'Rows Updated',
+ '$permissions' => $permissions,
+ ],
+ ],
+ ];
+
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+ $this->assertCount(10, $res['body']['data']['tablesUpdateRows']['rows']);
+
+ // Step 2: Fetch and validate updated rows
+ $query = $this->getQuery(self::$GET_ROWS);
+ $payload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['databaseId'],
+ 'tableId' => $data['tableId'],
+ 'queries' => [Query::equal('name', ['Rows Updated'])->toString()],
+ ],
+ ];
+
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertEquals(200, $res['headers']['status-code']);
+
+ $fetched = $res['body']['data']['tablesListRows'];
+ $this->assertEquals(10, $fetched['total']);
+
+ foreach ($fetched['rows'] as $row) {
+ $this->assertEquals($permissions, $row['_permissions']);
+ $this->assertEquals($data['tableId'], $row['_tableId']);
+ $this->assertEquals($data['databaseId'], $row['_databaseId']);
+ $this->assertEquals('Rows Updated', json_decode($row['data'], true)['name']);
+ }
+
+ return $data;
+ }
+
+ /**
+ * @depends testBulkCreate
+ */
+ public function testBulkUpsert(array $data): array
+ {
+ $userId = $this->getUser()['$id'];
+ $headers = array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $data['projectId'],
+ ], $this->getHeaders());
+
+ $permissions = [
+ Permission::read(Role::user($userId)),
+ Permission::update(Role::user($userId)),
+ Permission::delete(Role::user($userId)),
+ ];
+
+ // Step 1: Mutate row 10 and add row 11
+ $query = $this->getQuery(self::$UPSERT_ROWS);
+ $upsertPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['databaseId'],
+ 'tableId' => $data['tableId'],
+ 'rows' => [
+ [
+ '$id' => 'row10',
+ 'name' => 'Row #1000',
+ ],
+ [
+ 'name' => 'Row #11',
+ ],
+ ],
+ ],
+ ];
+
+ $response = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $upsertPayload);
+ $this->assertArrayNotHasKey('errors', $response['body']);
+
+ $rows = $response['body']['data']['tablesUpsertRows']['rows'];
+ $this->assertCount(2, $rows);
+
+ $rowMap = [];
+ foreach ($rows as $row) {
+ $decoded = json_decode($row['data'], true);
+ $rowMap[$decoded['name']] = $decoded;
+ }
+
+ $this->assertArrayHasKey('Row #1000', $rowMap);
+ $this->assertArrayHasKey('Row #11', $rowMap);
+
+ // Step 2: Fetch all rows and confirm count is now 11
+ $query = $this->getQuery(self::$GET_ROWS);
+ $fetchPayload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['databaseId'],
+ 'tableId' => $data['tableId'],
+ ],
+ ];
+
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $fetchPayload);
+ $this->assertEquals(200, $res['headers']['status-code']);
+
+ $fetched = $res['body']['data']['tablesListRows'];
+ $this->assertEquals(11, $fetched['total']);
+
+ // Step 3: Upsert row with new permissions using `tablesUpsertRow`
+ $query = $this->getQuery(self::$UPSERT_ROW);
+ $payload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['databaseId'],
+ 'tableId' => $data['tableId'],
+ 'rowId' => 'row10',
+ 'data' => ['name' => 'Row #10 Patched'],
+ 'permissions' => $permissions,
+ ],
+ ];
+
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+
+ $updated = $res['body']['data']['tablesUpsertRow'];
+ $this->assertEquals('Row #10 Patched', json_decode($updated['data'], true)['name']);
+ $this->assertEquals($data['databaseId'], $updated['_databaseId']);
+ $this->assertEquals($data['tableId'], $updated['_tableId']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testBulkUpsert
+ */
+ public function testBulkDelete(array $data): array
+ {
+ $headers = array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $data['projectId'],
+ ], $this->getHeaders());
+
+ // Step 1: Perform bulk delete
+ $query = $this->getQuery(self::$DELETE_ROWS);
+ $payload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['databaseId'],
+ 'tableId' => $data['tableId'],
+ ],
+ ];
+
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertArrayNotHasKey('errors', $res['body']);
+
+ $deleted = $res['body']['data']['tablesDeleteRows']['rows'];
+ $this->assertIsArray($deleted);
+ $this->assertCount(11, $deleted);
+
+ // Step 2: Confirm deletion via refetch
+ $query = $this->getQuery(self::$GET_ROWS);
+ $payload = [
+ 'query' => $query,
+ 'variables' => [
+ 'databaseId' => $data['databaseId'],
+ 'tableId' => $data['tableId'],
+ ],
+ ];
+
+ $res = $this->client->call(Client::METHOD_POST, '/graphql', $headers, $payload);
+ $this->assertEquals(200, $res['headers']['status-code']);
+ $this->assertEquals(0, $res['body']['data']['tablesListRows']['total']);
+
+ return $data;
+ }
+}
diff --git a/tests/e2e/Services/Projects/ProjectsConsoleClientTest.php b/tests/e2e/Services/Projects/ProjectsConsoleClientTest.php
index 1a9cf3b586..e297757225 100644
--- a/tests/e2e/Services/Projects/ProjectsConsoleClientTest.php
+++ b/tests/e2e/Services/Projects/ProjectsConsoleClientTest.php
@@ -483,7 +483,7 @@ class ProjectsConsoleClientTest extends Scope
$this->assertIsArray($response['body']['requests']);
$this->assertIsArray($response['body']['network']);
$this->assertIsNumeric($response['body']['executionsTotal']);
- $this->assertIsNumeric($response['body']['documentsTotal']);
+ $this->assertIsNumeric($response['body']['rowsTotal']);
$this->assertIsNumeric($response['body']['databasesTotal']);
$this->assertIsNumeric($response['body']['bucketsTotal']);
$this->assertIsNumeric($response['body']['usersTotal']);
@@ -2991,7 +2991,7 @@ class ProjectsConsoleClientTest extends Scope
'x-appwrite-project' => $this->getProject()['$id'],
], $this->getHeaders()), [
'name' => 'Key Test Update',
- 'scopes' => ['users.read', 'users.write', 'collections.read'],
+ 'scopes' => ['users.read', 'users.write', 'collections.read', 'tables.read'],
'expire' => DateTime::addSeconds(new \DateTime(), 360),
]);
@@ -3002,6 +3002,7 @@ class ProjectsConsoleClientTest extends Scope
$this->assertContains('users.read', $response['body']['scopes']);
$this->assertContains('users.write', $response['body']['scopes']);
$this->assertContains('collections.read', $response['body']['scopes']);
+ $this->assertContains('tables.read', $response['body']['scopes']);
$this->assertCount(3, $response['body']['scopes']);
$this->assertArrayHasKey('sdks', $response['body']);
$this->assertEmpty($response['body']['sdks']);
@@ -3020,6 +3021,7 @@ class ProjectsConsoleClientTest extends Scope
$this->assertContains('users.read', $response['body']['scopes']);
$this->assertContains('users.write', $response['body']['scopes']);
$this->assertContains('collections.read', $response['body']['scopes']);
+ $this->assertContains('tables.read', $response['body']['scopes']);
$this->assertCount(3, $response['body']['scopes']);
$this->assertArrayHasKey('sdks', $response['body']);
$this->assertEmpty($response['body']['sdks']);
@@ -4686,7 +4688,6 @@ class ProjectsConsoleClientTest extends Scope
'failure' => 'https://example.com'
]);
$this->assertEquals(400, $response['headers']['status-code']);
- $this->assertStringContainsString('Invalid `success` param: URL host must be one of: localhost, appwrite.io, *.appwrite.io', $response['body']);
/** Test oauth2 with devKey and now get oauth2 is disabled */
$response = $this->client->call(Client::METHOD_GET, '/account/sessions/oauth2/' . $provider, [
@@ -4709,7 +4710,6 @@ class ProjectsConsoleClientTest extends Scope
'url' => 'https://example.com',
]);
$this->assertEquals(400, $response['headers']['status-code']);
- $this->assertEquals('Invalid `url` param: URL host must be one of: localhost, appwrite.io, *.appwrite.io', $response['body']['message']);
/** Test hostname in Magic URL with devKey */
$response = $this->client->call(Client::METHOD_POST, '/account/sessions/magic-url', [
diff --git a/tests/e2e/Services/Realtime/RealtimeBase.php b/tests/e2e/Services/Realtime/RealtimeBase.php
index 99f31134c0..e9b60c4067 100644
--- a/tests/e2e/Services/Realtime/RealtimeBase.php
+++ b/tests/e2e/Services/Realtime/RealtimeBase.php
@@ -16,13 +16,6 @@ trait RealtimeBase
$projectId = $this->getProject()['$id'];
}
- $headers = array_merge(
- [
- "Origin" => "appwrite.test",
- ],
- $headers
- );
-
$query = [
"project" => $projectId,
"channels" => $channels,
@@ -42,14 +35,14 @@ trait RealtimeBase
/**
* Test for SUCCESS
*/
- $client = $this->getWebsocket(["documents"]);
+ $client = $this->getWebsocket(["rows"]);
$this->assertNotEmpty($client->receive());
$client->close();
}
public function testConnectionFailureMissingChannels(): void
{
- $client = $this->getWebsocket();
+ $client = $this->getWebsocket([]);
$payload = json_decode($client->receive(), true);
$this->assertArrayHasKey("type", $payload);
@@ -58,20 +51,13 @@ trait RealtimeBase
$this->assertEquals(1008, $payload["data"]["code"]);
$this->assertEquals("Missing channels", $payload["data"]["message"]);
\usleep(250000); // 250ms
- $this->expectException(ConnectionException::class); // Check if server disconnnected client
+ $this->expectException(ConnectionException::class); // Check if server disconnected client
$client->close();
}
public function testConnectionFailureUnknownProject(): void
{
- $client = new WebSocketClient(
- "ws://appwrite-traefik/v1/realtime?project=123",
- [
- "headers" => [
- "Origin" => "appwrite.test",
- ],
- ]
- );
+ $client = $this->getWebsocket(projectId: '123');
$payload = json_decode($client->receive(), true);
$this->assertArrayHasKey("type", $payload);
@@ -83,7 +69,7 @@ trait RealtimeBase
$payload["data"]["message"]
);
\usleep(250000); // 250ms
- $this->expectException(ConnectionException::class); // Check if server disconnnected client
+ $this->expectException(ConnectionException::class); // Check if server disconnected client
$client->close();
}
}
diff --git a/tests/e2e/Services/Realtime/RealtimeConsoleClientTest.php b/tests/e2e/Services/Realtime/RealtimeConsoleClientTest.php
index ba2d18694a..0d138566fd 100644
--- a/tests/e2e/Services/Realtime/RealtimeConsoleClientTest.php
+++ b/tests/e2e/Services/Realtime/RealtimeConsoleClientTest.php
@@ -123,9 +123,8 @@ class RealtimeConsoleClientTest extends Scope
$client->close();
}
- public function testAttributes(): array
+ public function testAttributesCollectionsAPI(): array
{
- $user = $this->getUser();
$projectId = 'console';
$client = $this->getWebsocket(['console'], [
@@ -184,13 +183,13 @@ class RealtimeConsoleClientTest extends Scope
]);
$projectId = $this->getProject()['$id'];
- $attributeKey = $name['body']['key'];
- $this->assertEquals($name['headers']['status-code'], 202);
- $this->assertEquals($name['body']['key'], 'name');
- $this->assertEquals($name['body']['type'], 'string');
- $this->assertEquals($name['body']['size'], 256);
- $this->assertEquals($name['body']['required'], true);
+ $this->assertEquals(202, $name['headers']['status-code']);
+ $this->assertEquals('name', $name['body']['key']);
+ $this->assertEquals('string', $name['body']['type']);
+ $this->assertEquals(256, $name['body']['size']);
+ $this->assertTrue($name['body']['required']);
+
$response = json_decode($client->receive(), true);
$this->assertArrayHasKey('type', $response);
@@ -235,15 +234,128 @@ class RealtimeConsoleClientTest extends Scope
$client->close();
- $data = ['actorsId' => $actorsId, 'databaseId' => $databaseId];
+ return ['actorsId' => $actorsId, 'databaseId' => $databaseId];
+ }
- return $data;
+ public function testAttributesTablesAPI(): array
+ {
+ $projectId = 'console';
+
+ $client = $this->getWebsocket(['console'], [
+ 'origin' => 'http://localhost',
+ 'cookie' => 'a_session_console=' . $this->getRoot()['session'],
+ ], $projectId);
+
+ $response = json_decode($client->receive(), true);
+
+ $this->assertArrayHasKey('type', $response);
+ $this->assertArrayHasKey('data', $response);
+ $this->assertEquals('connected', $response['type']);
+ $this->assertNotEmpty($response['data']);
+ $this->assertCount(1, $response['data']['channels']);
+ $this->assertContains('console', $response['data']['channels']);
+ $this->assertNotEmpty($response['data']['user']);
+
+ /**
+ * Create database
+ */
+ $database = $this->client->call(Client::METHOD_POST, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'databaseId' => ID::unique(),
+ 'name' => 'Actors DB',
+ ]);
+
+ $databaseId = $database['body']['$id'];
+
+ /**
+ * Test Attributes
+ */
+ $actors = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Actors',
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::create(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ ]);
+
+ $actorsId = $actors['body']['$id'];
+
+ $name = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $actorsId . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'key' => 'name',
+ 'size' => 256,
+ 'required' => true,
+ ]);
+
+ $projectId = $this->getProject()['$id'];
+
+ $this->assertEquals(202, $name['headers']['status-code']);
+ $this->assertEquals('name', $name['body']['key']);
+ $this->assertEquals('string', $name['body']['type']);
+ $this->assertEquals(256, $name['body']['size']);
+ $this->assertTrue($name['body']['required']);
+
+ $response = json_decode($client->receive(), true);
+
+ $this->assertArrayHasKey('type', $response);
+ $this->assertArrayHasKey('data', $response);
+ $this->assertEquals('event', $response['type']);
+ $this->assertNotEmpty($response['data']);
+ $this->assertArrayHasKey('timestamp', $response['data']);
+ $this->assertCount(2, $response['data']['channels']);
+ $this->assertContains('console', $response['data']['channels']);
+ $this->assertContains("projects.{$projectId}", $response['data']['channels']);
+ $this->assertContains("databases.{$databaseId}.tables.{$actorsId}.columns.*.create", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.{$actorsId}.columns.*", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.{$actorsId}", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.*.columns.*.create", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.*.columns.*", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.*", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}", $response['data']['events']);
+ $this->assertContains("databases.*", $response['data']['events']);
+ $this->assertNotEmpty($response['data']['payload']);
+ $this->assertEquals('processing', $response['data']['payload']['status']);
+
+ $response = json_decode($client->receive(), true);
+
+ $this->assertArrayHasKey('type', $response);
+ $this->assertArrayHasKey('data', $response);
+ $this->assertEquals('event', $response['type']);
+ $this->assertNotEmpty($response['data']);
+ $this->assertArrayHasKey('timestamp', $response['data']);
+ $this->assertCount(2, $response['data']['channels']);
+ $this->assertContains('console', $response['data']['channels']);
+ $this->assertContains("projects.{$projectId}", $response['data']['channels']);
+ $this->assertContains("databases.{$databaseId}.tables.{$actorsId}.columns.*.update", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.{$actorsId}.columns.*", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.{$actorsId}", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.*.columns.*.update", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.*.columns.*", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.*", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}", $response['data']['events']);
+ $this->assertContains("databases.*", $response['data']['events']);
+ $this->assertNotEmpty($response['data']['payload']);
+ $this->assertEquals('available', $response['data']['payload']['status']);
+
+ $client->close();
+
+ return ['actorsId' => $actorsId, 'databaseId' => $databaseId];
}
/**
- * @depends testAttributes
+ * @depends testAttributesCollectionsAPI
*/
- public function testIndexes(array $data)
+ public function testIndexesCollectionAPI(array $data)
{
$projectId = 'console';
$actorsId = $data['actorsId'];
@@ -277,10 +389,9 @@ class RealtimeConsoleClientTest extends Scope
],
]);
- $this->assertEquals($index['headers']['status-code'], 202);
+ $this->assertEquals(202, $index['headers']['status-code']);
$projectId = $this->getProject()['$id'];
- $indexKey = $index['body']['key'];
$response = json_decode($client->receive(), true);
@@ -326,9 +437,93 @@ class RealtimeConsoleClientTest extends Scope
}
/**
- * @depends testIndexes
+ * @depends testAttributesTablesAPI
*/
- public function testDeleteIndex(array $data)
+ public function testIndexesTablesAPI(array $data)
+ {
+ $projectId = 'console';
+ $actorsId = $data['actorsId'];
+ $databaseId = $data['databaseId'];
+ $client = $this->getWebsocket(['console'], [
+ 'origin' => 'http://localhost',
+ 'cookie' => 'a_session_console=' . $this->getRoot()['session'],
+ ], $projectId);
+
+ $response = json_decode($client->receive(), true);
+
+ $this->assertArrayHasKey('type', $response);
+ $this->assertArrayHasKey('data', $response);
+ $this->assertEquals('connected', $response['type']);
+ $this->assertNotEmpty($response['data']);
+ $this->assertCount(1, $response['data']['channels']);
+ $this->assertContains('console', $response['data']['channels']);
+ $this->assertNotEmpty($response['data']['user']);
+
+ /**
+ * Test Indexes
+ */
+ $index = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $actorsId . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'key' => 'key_name',
+ 'type' => 'key',
+ 'columns' => [
+ 'name',
+ ],
+ ]);
+
+ $this->assertEquals(202, $index['headers']['status-code']);
+
+ $projectId = $this->getProject()['$id'];
+
+ $response = json_decode($client->receive(), true);
+
+ $this->assertArrayHasKey('type', $response);
+ $this->assertArrayHasKey('data', $response);
+ $this->assertEquals('event', $response['type']);
+ $this->assertNotEmpty($response['data']);
+ $this->assertArrayHasKey('timestamp', $response['data']);
+ $this->assertCount(2, $response['data']['channels']);
+ $this->assertContains('console', $response['data']['channels']);
+ $this->assertContains("projects.{$projectId}", $response['data']['channels']);
+ $this->assertContains("databases.{$databaseId}.tables.{$actorsId}.indexes.*.create", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.{$actorsId}.indexes.*", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.{$actorsId}", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.*.indexes.*.create", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.*.indexes.*", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.*", $response['data']['events']);
+ $this->assertNotEmpty($response['data']['payload']);
+ $this->assertEquals('processing', $response['data']['payload']['status']);
+
+ $response = json_decode($client->receive(), true);
+
+ $this->assertArrayHasKey('type', $response);
+ $this->assertArrayHasKey('data', $response);
+ $this->assertEquals('event', $response['type']);
+ $this->assertNotEmpty($response['data']);
+ $this->assertArrayHasKey('timestamp', $response['data']);
+ $this->assertCount(2, $response['data']['channels']);
+ $this->assertContains('console', $response['data']['channels']);
+ $this->assertContains("projects.{$projectId}", $response['data']['channels']);
+ $this->assertContains("databases.{$databaseId}.tables.{$actorsId}.indexes.*.update", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.{$actorsId}.indexes.*", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.{$actorsId}", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.*.indexes.*.update", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.*.indexes.*", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.*", $response['data']['events']);
+ $this->assertNotEmpty($response['data']['payload']);
+ $this->assertEquals('available', $response['data']['payload']['status']);
+
+ $client->close();
+
+ return $data;
+ }
+
+ /**
+ * @depends testIndexesCollectionAPI
+ */
+ public function testDeleteIndexCollectionsAPI(array $data)
{
$actorsId = $data['actorsId'];
$projectId = 'console';
@@ -360,7 +555,7 @@ class RealtimeConsoleClientTest extends Scope
'x-appwrite-project' => $this->getProject()['$id'],
], $this->getHeaders()));
- $this->assertEquals($attribute['headers']['status-code'], 204);
+ $this->assertEquals(204, $attribute['headers']['status-code']);
$response = json_decode($client->receive(), true);
@@ -382,6 +577,7 @@ class RealtimeConsoleClientTest extends Scope
/** Delete index generates two events. One from the API and one from the database worker */
$response = json_decode($client->receive(), true);
+
$this->assertArrayHasKey('type', $response);
$this->assertArrayHasKey('data', $response);
$this->assertEquals('event', $response['type']);
@@ -404,12 +600,91 @@ class RealtimeConsoleClientTest extends Scope
}
/**
- * @depends testDeleteIndex
+ * @depends testIndexesTablesAPI
*/
- public function testDeleteAttribute(array $data)
+ public function testDeleteIndexTablesAPI(array $data)
{
- $actorsId = $data['actorsId'];
$projectId = 'console';
+ $actorsId = $data['actorsId'];
+ $databaseId = $data['databaseId'];
+
+ $client = $this->getWebsocket(['console'], [
+ 'origin' => 'http://localhost',
+ 'cookie' => 'a_session_console=' . $this->getRoot()['session'],
+ ], $projectId);
+
+ $response = json_decode($client->receive(), true);
+
+ $this->assertArrayHasKey('type', $response);
+ $this->assertArrayHasKey('data', $response);
+ $this->assertEquals('connected', $response['type']);
+ $this->assertNotEmpty($response['data']);
+ $this->assertCount(1, $response['data']['channels']);
+ $this->assertContains('console', $response['data']['channels']);
+ $this->assertNotEmpty($response['data']['user']);
+
+ $projectId = $this->getProject()['$id'];
+
+ /**
+ * Test Delete Index
+ */
+ $indexKey = 'key_name';
+ $attribute = $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $actorsId . '/indexes/' . $indexKey, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(204, $attribute['headers']['status-code']);
+
+ $response = json_decode($client->receive(), true);
+
+ $this->assertArrayHasKey('type', $response);
+ $this->assertArrayHasKey('data', $response);
+ $this->assertEquals('event', $response['type']);
+ $this->assertNotEmpty($response['data']);
+ $this->assertArrayHasKey('timestamp', $response['data']);
+ $this->assertCount(2, $response['data']['channels']);
+ $this->assertContains('console', $response['data']['channels']);
+ $this->assertContains("projects.{$projectId}", $response['data']['channels']);
+ $this->assertContains("databases.{$databaseId}.tables.{$actorsId}.indexes.*.update", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.{$actorsId}.indexes.*", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.{$actorsId}", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.*.indexes.*.update", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.*.indexes.*", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.*", $response['data']['events']);
+ $this->assertNotEmpty($response['data']['payload']);
+
+ /** Delete index generates two events. One from the API and one from the database worker */
+ $response = json_decode($client->receive(), true);
+
+ $this->assertArrayHasKey('type', $response);
+ $this->assertArrayHasKey('data', $response);
+ $this->assertEquals('event', $response['type']);
+ $this->assertNotEmpty($response['data']);
+ $this->assertArrayHasKey('timestamp', $response['data']);
+ $this->assertCount(2, $response['data']['channels']);
+ $this->assertContains('console', $response['data']['channels']);
+ $this->assertContains("projects.{$projectId}", $response['data']['channels']);
+ $this->assertContains("databases.{$databaseId}.tables.{$actorsId}.indexes.*.delete", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.{$actorsId}.indexes.*", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.{$actorsId}", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.*.indexes.*.delete", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.*.indexes.*", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.*", $response['data']['events']);
+ $this->assertNotEmpty($response['data']['payload']);
+
+ $client->close();
+
+ return $data;
+ }
+
+ /**
+ * @depends testDeleteIndexCollectionsAPI
+ */
+ public function testDeleteAttributeCollectionsAPI(array $data)
+ {
+ $projectId = 'console';
+ $actorsId = $data['actorsId'];
$databaseId = $data['databaseId'];
$client = $this->getWebsocket(['console'], [
@@ -438,7 +713,7 @@ class RealtimeConsoleClientTest extends Scope
'x-appwrite-project' => $this->getProject()['$id'],
], $this->getHeaders()));
- $this->assertEquals($attribute['headers']['status-code'], 204);
+ $this->assertEquals(204, $attribute['headers']['status-code']);
$response = json_decode($client->receive(), true);
$this->assertArrayHasKey('type', $response);
@@ -478,6 +753,81 @@ class RealtimeConsoleClientTest extends Scope
$client->close();
}
+ /**
+ * @depends testDeleteIndexTablesAPI
+ */
+ public function testDeleteAttributeTablesAPI(array $data)
+ {
+ $projectId = 'console';
+ $actorsId = $data['actorsId'];
+ $databaseId = $data['databaseId'];
+
+ $client = $this->getWebsocket(['console'], [
+ 'origin' => 'http://localhost',
+ 'cookie' => 'a_session_console=' . $this->getRoot()['session'],
+ ], $projectId);
+
+ $response = json_decode($client->receive(), true);
+
+ $this->assertArrayHasKey('type', $response);
+ $this->assertArrayHasKey('data', $response);
+ $this->assertEquals('connected', $response['type']);
+ $this->assertNotEmpty($response['data']);
+ $this->assertCount(1, $response['data']['channels']);
+ $this->assertContains('console', $response['data']['channels']);
+ $this->assertNotEmpty($response['data']['user']);
+
+ $attributeKey = 'name';
+ $projectId = $this->getProject()['$id'];
+
+ /**
+ * Test Delete Attribute
+ */
+ $attribute = $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $data['actorsId'] . '/columns/' . $attributeKey, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals(204, $attribute['headers']['status-code']);
+ $response = json_decode($client->receive(), true);
+
+ $this->assertArrayHasKey('type', $response);
+ $this->assertArrayHasKey('data', $response);
+ $this->assertEquals('event', $response['type']);
+ $this->assertNotEmpty($response['data']);
+ $this->assertArrayHasKey('timestamp', $response['data']);
+ $this->assertCount(2, $response['data']['channels']);
+ $this->assertContains('console', $response['data']['channels']);
+ $this->assertContains("projects.{$projectId}", $response['data']['channels']);
+ $this->assertContains("databases.{$databaseId}.tables.{$actorsId}.columns.*.update", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.{$actorsId}.columns.*", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.{$actorsId}", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.*.columns.*.update", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.*.columns.*", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.*", $response['data']['events']);
+ $this->assertNotEmpty($response['data']['payload']);
+
+ $response = json_decode($client->receive(), true);
+
+ $this->assertArrayHasKey('type', $response);
+ $this->assertArrayHasKey('data', $response);
+ $this->assertEquals('event', $response['type']);
+ $this->assertNotEmpty($response['data']);
+ $this->assertArrayHasKey('timestamp', $response['data']);
+ $this->assertCount(2, $response['data']['channels']);
+ $this->assertContains('console', $response['data']['channels']);
+ $this->assertContains("projects.{$projectId}", $response['data']['channels']);
+ $this->assertContains("databases.{$databaseId}.tables.{$actorsId}.columns.*.delete", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.{$actorsId}.columns.*", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.{$actorsId}", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.*.columns.*.delete", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.*.columns.*", $response['data']['events']);
+ $this->assertContains("databases.{$databaseId}.tables.*", $response['data']['events']);
+ $this->assertNotEmpty($response['data']['payload']);
+
+ $client->close();
+ }
+
public function testPing()
{
$client = $this->getWebsocket(['console'], [
@@ -607,10 +957,8 @@ class RealtimeConsoleClientTest extends Scope
$this->assertContains("projects.{$projectId}", $response['data']['channels']);
$this->assertArrayHasKey('buildLogs', $response['data']['payload']);
- if (!empty($response['data']['payload']['buildEndedAt'])) {
- $this->assertNotEmpty($response['data']['payload']['buildEndedAt']);
+ if (!empty($response['data']['payload']['buildSize'])) {
$this->assertNotEmpty($response['data']['payload']['buildStartedAt']);
- $this->assertNotEmpty($response['data']['payload']['buildDuration']);
$this->assertNotEmpty($response['data']['payload']['buildPath']);
$this->assertNotEmpty($response['data']['payload']['buildSize']);
$this->assertNotEmpty($response['data']['payload']['totalSize']);
@@ -618,7 +966,7 @@ class RealtimeConsoleClientTest extends Scope
break;
}
- // Ignore comparasion for first payload
+ // Ignore comparison for first payload
if ($previousBuildLogs !== null) {
$this->assertNotEquals($previousBuildLogs, $response['data']['payload']['buildLogs']);
}
@@ -634,6 +982,13 @@ class RealtimeConsoleClientTest extends Scope
$this->assertContains("projects.{$projectId}", $response['data']['channels']);
$this->assertEquals("ready", $response['data']['payload']['status']);
+ $response = json_decode($client->receive(), true);
+ $this->assertContains("functions.{$functionId}.deployments.{$deploymentId}.update", $response['data']['events']);
+ $this->assertContains('console', $response['data']['channels']);
+ $this->assertContains("projects.{$projectId}", $response['data']['channels']);
+ $this->assertNotEmpty($response['data']['payload']['buildDuration']);
+ $this->assertNotEmpty($response['data']['payload']['buildEndedAt']);
+
$client->close();
}
}
diff --git a/tests/e2e/Services/Realtime/RealtimeCustomClientTest.php b/tests/e2e/Services/Realtime/RealtimeCustomClientTest.php
index 9e3f1a66b7..dbb3b016be 100644
--- a/tests/e2e/Services/Realtime/RealtimeCustomClientTest.php
+++ b/tests/e2e/Services/Realtime/RealtimeCustomClientTest.php
@@ -81,11 +81,17 @@ class RealtimeCustomClientTest extends Scope
'files',
'files.1',
'collections',
+ 'tables',
'collections.1.documents',
'collections.2.documents',
+ 'tables.1.rows',
+ 'tables.2.rows',
'documents',
+ 'rows',
'collections.1.documents.1',
'collections.2.documents.2',
+ 'tables.1.rows.1',
+ 'tables.2.rows.2',
], $headers);
$response = json_decode($client->receive(), true);
@@ -95,17 +101,22 @@ class RealtimeCustomClientTest extends Scope
$this->assertEquals('connected', $response['type']);
$this->assertNotEmpty($response['data']);
$this->assertNotEmpty($response['data']['user']);
- $this->assertCount(10, $response['data']['channels']);
+ $this->assertCount(16, $response['data']['channels']);
$this->assertContains('account', $response['data']['channels']);
$this->assertContains('account.' . $userId, $response['data']['channels']);
$this->assertContains('files', $response['data']['channels']);
$this->assertContains('files.1', $response['data']['channels']);
$this->assertContains('collections', $response['data']['channels']);
+ $this->assertContains('tables', $response['data']['channels']);
$this->assertContains('collections.1.documents', $response['data']['channels']);
$this->assertContains('collections.2.documents', $response['data']['channels']);
+ $this->assertContains('tables.1.rows', $response['data']['channels']);
+ $this->assertContains('tables.2.rows', $response['data']['channels']);
$this->assertContains('documents', $response['data']['channels']);
$this->assertContains('collections.1.documents.1', $response['data']['channels']);
$this->assertContains('collections.2.documents.2', $response['data']['channels']);
+ $this->assertContains('tables.1.rows.1', $response['data']['channels']);
+ $this->assertContains('tables.2.rows.2', $response['data']['channels']);
$this->assertEquals($userId, $response['data']['user']['$id']);
$client->close();
@@ -415,7 +426,8 @@ class RealtimeCustomClientTest extends Scope
$this->assertContains("users.*", $response['data']['events']);
$lastEmail = $this->getLastEmail();
- $verification = substr($lastEmail['text'], strpos($lastEmail['text'], '&secret=', 0) + 8, 256);
+ $tokens = $this->extractQueryParamsFromEmailLink($lastEmail['html']);
+ $verification = $tokens['secret'];
/**
* Test Account Verification Complete
@@ -612,7 +624,8 @@ class RealtimeCustomClientTest extends Scope
$response = json_decode($client->receive(), true);
$lastEmail = $this->getLastEmail();
- $recovery = substr($lastEmail['text'], strpos($lastEmail['text'], '&secret=', 0) + 8, 256);
+ $tokens = $this->extractQueryParamsFromEmailLink($lastEmail['html']);
+ $recovery = $tokens['secret'];
$this->assertArrayHasKey('type', $response);
$this->assertArrayHasKey('data', $response);
@@ -734,11 +747,11 @@ class RealtimeCustomClientTest extends Scope
'required' => true,
]);
- $this->assertEquals($name['headers']['status-code'], 202);
- $this->assertEquals($name['body']['key'], 'name');
- $this->assertEquals($name['body']['type'], 'string');
- $this->assertEquals($name['body']['size'], 256);
- $this->assertEquals($name['body']['required'], true);
+ $this->assertEquals(202, $name['headers']['status-code']);
+ $this->assertEquals('name', $name['body']['key']);
+ $this->assertEquals('string', $name['body']['type']);
+ $this->assertEquals(256, $name['body']['size']);
+ $this->assertTrue($name['body']['required']);
sleep(2);
@@ -768,7 +781,7 @@ class RealtimeCustomClientTest extends Scope
$this->assertEquals('event', $response['type']);
$this->assertNotEmpty($response['data']);
$this->assertArrayHasKey('timestamp', $response['data']);
- $this->assertCount(3, $response['data']['channels']);
+ $this->assertCount(6, $response['data']['channels']);
$this->assertContains('documents', $response['data']['channels']);
$this->assertContains('databases.' . $databaseId . '.collections.' . $actorsId . '.documents.' . $documentId, $response['data']['channels']);
$this->assertContains('databases.' . $databaseId . '.collections.' . $actorsId . '.documents', $response['data']['channels']);
@@ -785,7 +798,7 @@ class RealtimeCustomClientTest extends Scope
$this->assertContains("databases.{$databaseId}", $response['data']['events']);
$this->assertContains("databases.*", $response['data']['events']);
$this->assertNotEmpty($response['data']['payload']);
- $this->assertEquals($response['data']['payload']['name'], 'Chris Evans');
+ $this->assertEquals('Chris Evans', $response['data']['payload']['name']);
/**
* Test Document Update
@@ -812,7 +825,7 @@ class RealtimeCustomClientTest extends Scope
$this->assertEquals('event', $response['type']);
$this->assertNotEmpty($response['data']);
$this->assertArrayHasKey('timestamp', $response['data']);
- $this->assertCount(3, $response['data']['channels']);
+ $this->assertCount(6, $response['data']['channels']);
$this->assertContains('documents', $response['data']['channels']);
$this->assertContains("databases.{$databaseId}.collections.{$actorsId}.documents.{$documentId}", $response['data']['channels']);
$this->assertContains("databases.{$databaseId}.collections.{$actorsId}.documents", $response['data']['channels']);
@@ -830,7 +843,7 @@ class RealtimeCustomClientTest extends Scope
$this->assertContains("databases.*", $response['data']['events']);
$this->assertNotEmpty($response['data']['payload']);
- $this->assertEquals($response['data']['payload']['name'], 'Chris Evans 2');
+ $this->assertEquals('Chris Evans 2', $response['data']['payload']['name']);
/**
* Test Document Delete
@@ -866,7 +879,7 @@ class RealtimeCustomClientTest extends Scope
$this->assertEquals('event', $response['type']);
$this->assertNotEmpty($response['data']);
$this->assertArrayHasKey('timestamp', $response['data']);
- $this->assertCount(3, $response['data']['channels']);
+ $this->assertCount(6, $response['data']['channels']);
$this->assertContains('documents', $response['data']['channels']);
$this->assertContains("databases.{$databaseId}.collections.{$actorsId}.documents.{$documentId}", $response['data']['channels']);
$this->assertContains("databases.{$databaseId}.collections.{$actorsId}.documents", $response['data']['channels']);
@@ -883,7 +896,7 @@ class RealtimeCustomClientTest extends Scope
$this->assertContains("databases.{$databaseId}", $response['data']['events']);
$this->assertContains("databases.*", $response['data']['events']);
$this->assertNotEmpty($response['data']['payload']);
- $this->assertEquals($response['data']['payload']['name'], 'Bradley Cooper');
+ $this->assertEquals('Bradley Cooper', $response['data']['payload']['name']);
$client->close();
}
@@ -955,11 +968,11 @@ class RealtimeCustomClientTest extends Scope
'required' => true,
]);
- $this->assertEquals($name['headers']['status-code'], 202);
- $this->assertEquals($name['body']['key'], 'name');
- $this->assertEquals($name['body']['type'], 'string');
- $this->assertEquals($name['body']['size'], 256);
- $this->assertEquals($name['body']['required'], true);
+ $this->assertEquals(202, $name['headers']['status-code']);
+ $this->assertEquals('name', $name['body']['key']);
+ $this->assertEquals('string', $name['body']['type']);
+ $this->assertEquals(256, $name['body']['size']);
+ $this->assertTrue($name['body']['required']);
sleep(2);
@@ -986,7 +999,7 @@ class RealtimeCustomClientTest extends Scope
$this->assertEquals('event', $response['type']);
$this->assertNotEmpty($response['data']);
$this->assertArrayHasKey('timestamp', $response['data']);
- $this->assertCount(3, $response['data']['channels']);
+ $this->assertCount(6, $response['data']['channels']);
$this->assertContains('documents', $response['data']['channels']);
$this->assertContains("databases.{$databaseId}.collections.{$actorsId}.documents.{$documentId}", $response['data']['channels']);
$this->assertContains("databases.{$databaseId}.collections.{$actorsId}.documents", $response['data']['channels']);
@@ -1003,7 +1016,7 @@ class RealtimeCustomClientTest extends Scope
$this->assertContains("databases.{$databaseId}", $response['data']['events']);
$this->assertContains("databases.*", $response['data']['events']);
$this->assertNotEmpty($response['data']['payload']);
- $this->assertEquals($response['data']['payload']['name'], 'Chris Evans');
+ $this->assertEquals('Chris Evans', $response['data']['payload']['name']);
/**
* Test Document Update
@@ -1025,7 +1038,7 @@ class RealtimeCustomClientTest extends Scope
$this->assertEquals('event', $response['type']);
$this->assertNotEmpty($response['data']);
$this->assertArrayHasKey('timestamp', $response['data']);
- $this->assertCount(3, $response['data']['channels']);
+ $this->assertCount(6, $response['data']['channels']);
$this->assertContains('documents', $response['data']['channels']);
$this->assertContains("databases.{$databaseId}.collections.{$actorsId}.documents.{$documentId}", $response['data']['channels']);
$this->assertContains("databases.{$databaseId}.collections.{$actorsId}.documents", $response['data']['channels']);
@@ -1043,7 +1056,7 @@ class RealtimeCustomClientTest extends Scope
$this->assertContains("databases.*", $response['data']['events']);
$this->assertNotEmpty($response['data']['payload']);
- $this->assertEquals($response['data']['payload']['name'], 'Chris Evans 2');
+ $this->assertEquals('Chris Evans 2', $response['data']['payload']['name']);
/**
* Test Document Delete
@@ -1075,7 +1088,7 @@ class RealtimeCustomClientTest extends Scope
$this->assertEquals('event', $response['type']);
$this->assertNotEmpty($response['data']);
$this->assertArrayHasKey('timestamp', $response['data']);
- $this->assertCount(3, $response['data']['channels']);
+ $this->assertCount(6, $response['data']['channels']);
$this->assertContains('documents', $response['data']['channels']);
$this->assertContains("databases.{$databaseId}.collections.{$actorsId}.documents.{$documentId}", $response['data']['channels']);
$this->assertContains("databases.{$databaseId}.collections.{$actorsId}.documents", $response['data']['channels']);
@@ -1092,7 +1105,7 @@ class RealtimeCustomClientTest extends Scope
$this->assertContains("databases.{$databaseId}", $response['data']['events']);
$this->assertContains("databases.*", $response['data']['events']);
$this->assertNotEmpty($response['data']['payload']);
- $this->assertEquals($response['data']['payload']['name'], 'Bradley Cooper');
+ $this->assertEquals('Bradley Cooper', $response['data']['payload']['name']);
$client->close();
}
@@ -1292,7 +1305,7 @@ class RealtimeCustomClientTest extends Scope
$functionId = $function['body']['$id'] ?? '';
- $this->assertEquals($function['headers']['status-code'], 201);
+ $this->assertEquals(201, $function['headers']['status-code']);
$this->assertNotEmpty($function['body']['$id']);
$deployment = $this->client->call(Client::METHOD_POST, '/functions/' . $functionId . '/deployments', array_merge([
@@ -1307,7 +1320,7 @@ class RealtimeCustomClientTest extends Scope
$deploymentId = $deployment['body']['$id'] ?? '';
- $this->assertEquals($deployment['headers']['status-code'], 202);
+ $this->assertEquals(202, $deployment['headers']['status-code']);
$this->assertNotEmpty($deployment['body']['$id']);
// Poll until deployment is built
@@ -1467,7 +1480,7 @@ class RealtimeCustomClientTest extends Scope
'name' => 'Manchester'
]);
- $this->assertEquals($team['headers']['status-code'], 200);
+ $this->assertEquals(200, $team['headers']['status-code']);
$this->assertNotEmpty($team['body']['$id']);
$response = json_decode($client->receive(), true);
@@ -1499,9 +1512,9 @@ class RealtimeCustomClientTest extends Scope
]
]);
- $this->assertEquals($team['headers']['status-code'], 200);
- $this->assertEquals($team['body']['funcKey1'], 'funcValue1');
- $this->assertEquals($team['body']['funcKey2'], 'funcValue2');
+ $this->assertEquals(200, $team['headers']['status-code']);
+ $this->assertEquals('funcValue1', $team['body']['funcKey1']);
+ $this->assertEquals('funcValue2', $team['body']['funcKey2']);
$response = json_decode($client->receive(), true);
@@ -1520,8 +1533,8 @@ class RealtimeCustomClientTest extends Scope
$this->assertContains("teams.*.update", $response['data']['events']);
$this->assertContains("teams.*", $response['data']['events']);
$this->assertNotEmpty($response['data']['payload']);
- $this->assertEquals($response['data']['payload']['funcKey1'], 'funcValue1');
- $this->assertEquals($response['data']['payload']['funcKey2'], 'funcValue2');
+ $this->assertEquals('funcValue1', $response['data']['payload']['funcKey1']);
+ $this->assertEquals('funcValue2', $response['data']['payload']['funcKey2']);
$client->close();
diff --git a/tests/e2e/Services/Sites/SitesCustomClientTest.php b/tests/e2e/Services/Sites/SitesCustomClientTest.php
index 9bf389ea62..42fe26d216 100644
--- a/tests/e2e/Services/Sites/SitesCustomClientTest.php
+++ b/tests/e2e/Services/Sites/SitesCustomClientTest.php
@@ -6,6 +6,7 @@ use Tests\E2E\Client;
use Tests\E2E\Scopes\ProjectCustom;
use Tests\E2E\Scopes\Scope;
use Tests\E2E\Scopes\SideClient;
+use Utopia\System\System;
class SitesCustomClientTest extends Scope
{
@@ -121,6 +122,7 @@ class SitesCustomClientTest extends Scope
* Test for SUCCESS
*/
$template = $this->getTemplate('starter-for-react');
+ $hostname = System::getEnv('_APP_DOMAIN') ?: '';
$this->assertEquals(200, $template['headers']['status-code']);
$this->assertIsArray($template['body']);
$this->assertEquals('starter-for-react', $template['body']['key']);
@@ -129,8 +131,8 @@ class SitesCustomClientTest extends Scope
$this->assertEquals('github', $template['body']['vcsProvider']);
$this->assertEquals('Simple React application integrated with Appwrite SDK.', $template['body']['tagline']);
$this->assertIsArray($template['body']['frameworks']);
- $this->assertEquals('http://localhost/images/sites/templates/starter-for-react-dark.png', $template['body']['screenshotDark']);
- $this->assertEquals('http://localhost/images/sites/templates/starter-for-react-light.png', $template['body']['screenshotLight']);
+ $this->assertEquals('http://'. $hostname . '/images/sites/templates/starter-for-react-dark.png', $template['body']['screenshotDark']);
+ $this->assertEquals('http://' . $hostname . '/images/sites/templates/starter-for-react-light.png', $template['body']['screenshotLight']);
/**
* Test for FAILURE
diff --git a/tests/e2e/Services/Teams/TeamsBaseClient.php b/tests/e2e/Services/Teams/TeamsBaseClient.php
index 1858fd50ad..5c8e94feb1 100644
--- a/tests/e2e/Services/Teams/TeamsBaseClient.php
+++ b/tests/e2e/Services/Teams/TeamsBaseClient.php
@@ -223,8 +223,10 @@ trait TeamsBaseClient
$this->assertEquals($email, $lastEmail['to'][0]['address']);
$this->assertEquals($name, $lastEmail['to'][0]['name']);
$this->assertEquals('Invitation to ' . $teamName . ' Team at ' . $this->getProject()['name'], $lastEmail['subject']);
- $this->assertEquals($response['body']['teamId'], substr($lastEmail['text'], strpos($lastEmail['text'], '&teamId=', 0) + 8, 20));
- $this->assertEquals($teamName, substr($lastEmail['text'], strpos($lastEmail['text'], '&teamName=', 0) + 10, 7));
+
+ $tokens = $this->extractQueryParamsFromEmailLink($lastEmail['html']);
+ $this->assertEquals($teamName, $tokens['teamName']);
+ $this->assertEquals($response['body']['teamId'], $tokens['teamId']);
/**
* Test with UserId
@@ -288,8 +290,10 @@ trait TeamsBaseClient
$this->assertEquals($secondEmail, $lastEmail['to'][0]['address']);
$this->assertEquals($secondName, $lastEmail['to'][0]['name']);
$this->assertEquals('Invitation to ' . $teamName . ' Team at ' . $this->getProject()['name'], $lastEmail['subject']);
- $this->assertEquals($response['body']['teamId'], substr($lastEmail['text'], strpos($lastEmail['text'], '&teamId=', 0) + 8, 20));
- $this->assertEquals($teamName, substr($lastEmail['text'], strpos($lastEmail['text'], '&teamName=', 0) + 10, 7));
+
+ $tokens = $this->extractQueryParamsFromEmailLink($lastEmail['html']);
+ $this->assertEquals($teamName, $tokens['teamName']);
+ $this->assertEquals($response['body']['teamId'], $tokens['teamId']);
// test for resending invitation
$response = $this->client->call(Client::METHOD_POST, '/teams/' . $teamUid . '/memberships', array_merge([
@@ -305,9 +309,10 @@ trait TeamsBaseClient
$this->assertEquals(201, $response['headers']['status-code']);
$lastEmail = $this->getLastEmail();
- $membershipUid = substr($lastEmail['text'], strpos($lastEmail['text'], '?membershipId=', 0) + 14, 20);
- $userUid = substr($lastEmail['text'], strpos($lastEmail['text'], '&userId=', 0) + 8, 20);
- $secret = substr($lastEmail['text'], strpos($lastEmail['text'], '&secret=', 0) + 8, 256);
+ $tokens = $this->extractQueryParamsFromEmailLink($lastEmail['html']);
+ $membershipUid = $tokens['membershipId'];
+ $userUid = $tokens['userId'];
+ $secret = $tokens['secret'];
/**
* Test for FAILURE
@@ -338,11 +343,11 @@ trait TeamsBaseClient
$this->assertEquals(400, $response['headers']['status-code']);
return [
- 'teamUid' => $teamUid,
- 'teamName' => $teamName,
- 'secret' => $secret,
- 'membershipUid' => $membershipUid,
- 'userUid' => $userUid,
+ 'teamUid' => $tokens['teamId'],
+ 'teamName' => $tokens['teamName'],
+ 'secret' => $tokens['secret'],
+ 'membershipUid' => $tokens['membershipId'],
+ 'userUid' => $tokens['userId'],
'email' => $email,
'name' => $name
];
@@ -600,10 +605,11 @@ trait TeamsBaseClient
$this->assertEquals(201, $response['headers']['status-code']);
$lastEmail = $this->getLastEmail();
+ $tokens = $this->extractQueryParamsFromEmailLink($lastEmail['html']);
- $secret = substr($lastEmail['text'], strpos($lastEmail['text'], '&secret=', 0) + 8, 256);
- $membershipUid = substr($lastEmail['text'], strpos($lastEmail['text'], '?membershipId=', 0) + 14, 20);
- $userUid = substr($lastEmail['text'], strpos($lastEmail['text'], '&userId=', 0) + 8, 20);
+ $secret = $tokens['secret'];
+ $membershipUid = $tokens['membershipId'];
+ $userUid = $tokens['userId'];
$response = $this->client->call(Client::METHOD_PATCH, '/teams/' . $teamUid . '/memberships/' . $membershipUid . '/status', [
'origin' => 'http://localhost',
diff --git a/tests/e2e/Services/Teams/TeamsCustomClientTest.php b/tests/e2e/Services/Teams/TeamsCustomClientTest.php
index 7286bb0827..e30dacac74 100644
--- a/tests/e2e/Services/Teams/TeamsCustomClientTest.php
+++ b/tests/e2e/Services/Teams/TeamsCustomClientTest.php
@@ -6,6 +6,7 @@ use Tests\E2E\Client;
use Tests\E2E\Scopes\ProjectCustom;
use Tests\E2E\Scopes\Scope;
use Tests\E2E\Scopes\SideClient;
+use Utopia\CLI\Console;
class TeamsCustomClientTest extends Scope
{
@@ -152,11 +153,14 @@ class TeamsCustomClientTest extends Scope
$this->assertEquals(201, $response['headers']['status-code']);
$email = $this->getLastEmail();
+ Console::log(json_encode([
+ 'testTeamsInviteHTMLInjection' => $email
+ ], JSON_PRETTY_PRINT));
+
$encoded = 'http://localhost:5000/join-us\"></a><h1>INJECTED</h1>?';
$this->assertStringNotContainsString('INJECTED
', $email['html']);
$this->assertStringContainsString($encoded, $email['html']);
- $this->assertStringContainsString($encoded, $email['text']);
$response = $this->client->call(Client::METHOD_DELETE, '/teams/' . $teamUid . '/memberships/'.$response['body']['$id'], array_merge([
'content-type' => 'application/json',
diff --git a/tests/e2e/Services/Webhooks/WebhooksBase.php b/tests/e2e/Services/Webhooks/WebhooksBase.php
index c743810feb..fe9a4ed366 100644
--- a/tests/e2e/Services/Webhooks/WebhooksBase.php
+++ b/tests/e2e/Services/Webhooks/WebhooksBase.php
@@ -36,7 +36,7 @@ trait WebhooksBase
return base64_encode(hash_hmac('sha1', $url . $payload, $signatureKey, true));
}
-
+ // Collection APIs
public function testCreateCollection(): array
{
/**
@@ -389,6 +389,356 @@ trait WebhooksBase
return $data;
}
+ // Table APIs
+ public function testCreateTable(): array
+ {
+ /**
+ * Create database
+ */
+ $database = $this->client->call(Client::METHOD_POST, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'databaseId' => ID::unique(),
+ 'name' => 'Actors DB',
+ ]);
+
+ $databaseId = $database['body']['$id'];
+
+ /**
+ * Test for SUCCESS
+ */
+ $actors = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Actors',
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::create(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ 'rowSecurity' => true,
+ ]);
+
+ $actorsId = $actors['body']['$id'];
+
+ $this->assertEquals($actors['headers']['status-code'], 201);
+ $this->assertNotEmpty($actors['body']['$id']);
+
+ $webhook = $this->getLastRequest();
+ $signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
+
+ $this->assertEquals($webhook['method'], 'POST');
+ $this->assertEquals($webhook['headers']['Content-Type'], 'application/json');
+ $this->assertEquals($webhook['headers']['User-Agent'], 'Appwrite-Server vdev. Please report abuse at security@appwrite.io');
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*.create', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}.create", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Signature'], $signatureExpected);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Id'] ?? '', $this->getProject()['webhookId']);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Project-Id'] ?? '', $this->getProject()['$id']);
+ $this->assertEquals(empty($webhook['headers']['X-Appwrite-Webhook-User-Id'] ?? ''), true);
+ $this->assertNotEmpty($webhook['data']['$id']);
+ $this->assertEquals($webhook['data']['name'], 'Actors');
+ $this->assertIsArray($webhook['data']['$permissions']);
+ $this->assertCount(4, $webhook['data']['$permissions']);
+
+ return array_merge(['actorsId' => $actorsId, 'databaseId' => $databaseId]);
+ }
+
+ /**
+ * @depends testCreateTable
+ */
+ public function testCreateColumns(array $data): array
+ {
+ $actorsId = $data['actorsId'];
+ $databaseId = $data['databaseId'];
+
+ $firstName = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $actorsId . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'firstName',
+ 'size' => 256,
+ 'required' => true,
+ ]);
+
+ $lastName = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $actorsId . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'lastName',
+ 'size' => 256,
+ 'required' => true,
+ ]);
+
+ $extra = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $actorsId . '/columns/string', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'extra',
+ 'size' => 64,
+ 'required' => false,
+ ]);
+
+ $this->assertEquals($firstName['headers']['status-code'], 202);
+ $this->assertEquals($firstName['body']['key'], 'firstName');
+ $this->assertEquals($lastName['headers']['status-code'], 202);
+ $this->assertEquals($lastName['body']['key'], 'lastName');
+ $this->assertEquals($extra['headers']['status-code'], 202);
+ $this->assertEquals($extra['body']['key'], 'extra');
+
+ // wait for database worker to kick in
+ sleep(10);
+
+ $webhook = $this->getLastRequest();
+ $signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
+
+ $this->assertEquals($webhook['method'], 'POST');
+ $this->assertEquals($webhook['headers']['Content-Type'], 'application/json');
+ $this->assertEquals($webhook['headers']['User-Agent'], 'Appwrite-Server vdev. Please report abuse at security@appwrite.io');
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*.columns.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*.columns.*.create', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}.columns.*", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}.columns.*.create", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Signature'], $signatureExpected);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Id'] ?? '', $this->getProject()['webhookId']);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Project-Id'] ?? '', $this->getProject()['$id']);
+ $this->assertNotEmpty($webhook['data']['key']);
+ $this->assertEquals($webhook['data']['key'], 'extra');
+
+ $removed = $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $data['actorsId'] . '/columns/' . $extra['body']['key'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals(204, $removed['headers']['status-code']);
+
+ $webhook = $this->getLastRequest();
+ $signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
+
+ // $this->assertEquals($webhook['method'], 'DELETE');
+ $this->assertEquals($webhook['headers']['Content-Type'], 'application/json');
+ $this->assertEquals($webhook['headers']['User-Agent'], 'Appwrite-Server vdev. Please report abuse at security@appwrite.io');
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*.columns.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*.columns.*.update', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}.columns.*", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}.columns.*.update", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Signature'], $signatureExpected);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Id'] ?? '', $this->getProject()['webhookId']);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Project-Id'] ?? '', $this->getProject()['$id']);
+ $this->assertNotEmpty($webhook['data']['key']);
+ $this->assertEquals($webhook['data']['key'], 'extra');
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateColumns
+ */
+ public function testCreateRow(array $data): array
+ {
+ $actorsId = $data['actorsId'];
+ $databaseId = $data['databaseId'];
+
+ /**
+ * Test for SUCCESS
+ */
+ $row = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $actorsId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'firstName' => 'Chris',
+ 'lastName' => 'Evans',
+ ],
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ ]);
+
+ $documentId = $row['body']['$id'];
+
+ $this->assertEquals($row['headers']['status-code'], 201);
+ $this->assertNotEmpty($row['body']['$id']);
+
+ $webhook = $this->getLastRequest();
+ $signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
+
+ $this->assertEquals($webhook['method'], 'POST');
+ $this->assertEquals($webhook['headers']['Content-Type'], 'application/json');
+ $this->assertEquals($webhook['headers']['User-Agent'], 'Appwrite-Server vdev. Please report abuse at security@appwrite.io');
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*.rows.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*.rows.*.create', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.*.rows.{$documentId}", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.*.rows.{$documentId}.create", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}.rows.*", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}.rows.*.create", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}.rows.{$documentId}", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}.rows.{$documentId}.create", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Signature'], $signatureExpected);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Id'] ?? '', $this->getProject()['webhookId']);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Project-Id'] ?? '', $this->getProject()['$id']);
+ $this->assertEquals(empty($webhook['headers']['X-Appwrite-Webhook-User-Id'] ?? ''), ('server' === $this->getSide()));
+ $this->assertNotEmpty($webhook['data']['$id']);
+ $this->assertEquals($webhook['data']['firstName'], 'Chris');
+ $this->assertEquals($webhook['data']['lastName'], 'Evans');
+ $this->assertIsArray($webhook['data']['$permissions']);
+ $this->assertCount(3, $webhook['data']['$permissions']);
+
+ $data['rowId'] = $row['body']['$id'];
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateRow
+ */
+ public function testUpdateRow(array $data): array
+ {
+ $actorsId = $data['actorsId'];
+ $databaseId = $data['databaseId'];
+
+ /**
+ * Test for SUCCESS
+ */
+ $document = $this->client->call(Client::METHOD_PATCH, '/databases/' . $databaseId . '/tables/' . $actorsId . '/rows/' . $data['rowId'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'data' => [
+ 'firstName' => 'Chris1',
+ 'lastName' => 'Evans2',
+ ],
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ ]);
+
+ $rowId = $document['body']['$id'];
+
+ $this->assertEquals($document['headers']['status-code'], 200);
+ $this->assertNotEmpty($document['body']['$id']);
+
+ $webhook = $this->getLastRequest();
+ $signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
+
+ $this->assertEquals($webhook['method'], 'POST');
+ $this->assertEquals($webhook['headers']['Content-Type'], 'application/json');
+ $this->assertEquals($webhook['headers']['User-Agent'], 'Appwrite-Server vdev. Please report abuse at security@appwrite.io');
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*.rows.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*.rows.*.update', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.*.rows.{$rowId}", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.*.rows.{$rowId}.update", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}.rows.*", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}.rows.*.update", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}.rows.{$rowId}", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}.rows.{$rowId}.update", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Signature'], $signatureExpected);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Id'] ?? '', $this->getProject()['webhookId']);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Project-Id'] ?? '', $this->getProject()['$id']);
+ $this->assertEquals(empty($webhook['headers']['X-Appwrite-Webhook-User-Id'] ?? ''), ('server' === $this->getSide()));
+ $this->assertNotEmpty($webhook['data']['$id']);
+ $this->assertEquals($webhook['data']['firstName'], 'Chris1');
+ $this->assertEquals($webhook['data']['lastName'], 'Evans2');
+ $this->assertIsArray($webhook['data']['$permissions']);
+ $this->assertCount(3, $webhook['data']['$permissions']);
+
+ return $data;
+ }
+
+ /**
+ * @depends testCreateTable
+ */
+ #[Retry(count: 1)]
+ public function testDeleteRow(array $data): array
+ {
+ $actorsId = $data['actorsId'];
+ $databaseId = $data['databaseId'];
+
+ /**
+ * Test for SUCCESS
+ */
+ $row = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $actorsId . '/rows', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()), [
+ 'rowId' => ID::unique(),
+ 'data' => [
+ 'firstName' => 'Bradly',
+ 'lastName' => 'Cooper',
+
+ ],
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ ]);
+
+ $rowId = $row['body']['$id'];
+
+ $this->assertEquals($row['headers']['status-code'], 201);
+ $this->assertNotEmpty($row['body']['$id']);
+
+ $row = $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $actorsId . '/rows/' . $row['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ ], $this->getHeaders()));
+
+ $this->assertEquals($row['headers']['status-code'], 204);
+
+ $webhook = $this->getLastRequest();
+ $signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
+
+ $this->assertEquals($webhook['method'], 'POST');
+ $this->assertEquals($webhook['headers']['Content-Type'], 'application/json');
+ $this->assertEquals($webhook['headers']['User-Agent'], 'Appwrite-Server vdev. Please report abuse at security@appwrite.io');
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*.rows.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*.rows.*.delete', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.*.rows.{$rowId}", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.*.rows.{$rowId}.delete", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}.rows.*", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}.rows.*.delete", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}.rows.{$rowId}", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}.rows.{$rowId}.delete", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Signature'], $signatureExpected);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Id'] ?? '', $this->getProject()['webhookId']);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Project-Id'] ?? '', $this->getProject()['$id']);
+ $this->assertEquals(empty($webhook['headers']['X-Appwrite-Webhook-User-Id'] ?? ''), ('server' === $this->getSide()));
+ $this->assertNotEmpty($webhook['data']['$id']);
+ $this->assertEquals($webhook['data']['firstName'], 'Bradly');
+ $this->assertEquals($webhook['data']['lastName'], 'Cooper');
+ $this->assertIsArray($webhook['data']['$permissions']);
+ $this->assertCount(3, $webhook['data']['$permissions']);
+
+ return $data;
+ }
public function testCreateStorageBucket(): array
{
@@ -921,7 +1271,10 @@ trait WebhooksBase
$lastEmail = $this->getLastEmail();
- $secret = substr($lastEmail['text'], strpos($lastEmail['text'], '&secret=', 0) + 8, 256);
+ // `$isAppUser` — no email expected;
+ $tokens = $this->extractQueryParamsFromEmailLink($lastEmail['html'] ?? '');
+
+ $secret = $tokens['secret'] ?? '';
$membershipId = $team['body']['$id'];
$webhook = $this->getLastRequest();
diff --git a/tests/e2e/Services/Webhooks/WebhooksCustomClientTest.php b/tests/e2e/Services/Webhooks/WebhooksCustomClientTest.php
index a170492551..bcc4ede30a 100644
--- a/tests/e2e/Services/Webhooks/WebhooksCustomClientTest.php
+++ b/tests/e2e/Services/Webhooks/WebhooksCustomClientTest.php
@@ -894,9 +894,9 @@ class WebhooksCustomClientTest extends Scope
$url = $webhook['url'];
$signatureExpected = base64_encode(hash_hmac('sha1', $url . $payload, $signatureKey, true));
- $this->assertEquals($webhook['method'], 'POST');
- $this->assertEquals($webhook['headers']['Content-Type'], 'application/json');
- $this->assertEquals($webhook['headers']['User-Agent'], 'Appwrite-Server vdev. Please report abuse at security@appwrite.io');
+ $this->assertEquals('POST', $webhook['method']);
+ $this->assertEquals('application/json', $webhook['headers']['Content-Type']);
+ $this->assertEquals('Appwrite-Server vdev. Please report abuse at security@appwrite.io', $webhook['headers']['User-Agent']);
$this->assertStringContainsString('teams.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
$this->assertStringContainsString('teams.*.memberships.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
$this->assertStringContainsString('teams.*.memberships.*.update', $webhook['headers']['X-Appwrite-Webhook-Events']);
@@ -919,8 +919,8 @@ class WebhooksCustomClientTest extends Scope
$this->assertNotEmpty($webhook['data']['userId']);
$this->assertNotEmpty($webhook['data']['teamId']);
$this->assertCount(2, $webhook['data']['roles']);
- $this->assertEquals(true, (new DatetimeValidator())->isValid($webhook['data']['joined']));
- $this->assertEquals(true, $webhook['data']['confirm']);
+ $this->assertTrue((new DatetimeValidator())->isValid($webhook['data']['joined']));
+ $this->assertTrue($webhook['data']['confirm']);
/**
* Test for FAILURE
diff --git a/tests/e2e/Services/Webhooks/WebhooksCustomServerTest.php b/tests/e2e/Services/Webhooks/WebhooksCustomServerTest.php
index d2f132e960..6fe184b03f 100644
--- a/tests/e2e/Services/Webhooks/WebhooksCustomServerTest.php
+++ b/tests/e2e/Services/Webhooks/WebhooksCustomServerTest.php
@@ -19,6 +19,7 @@ class WebhooksCustomServerTest extends Scope
use ProjectCustom;
use SideServer;
+ // Collection APIs
/**
* @depends testCreateAttributes
*/
@@ -39,15 +40,15 @@ class WebhooksCustomServerTest extends Scope
'documentSecurity' => true,
]);
- $this->assertEquals($actors['headers']['status-code'], 200);
+ $this->assertEquals(200, $actors['headers']['status-code']);
$this->assertNotEmpty($actors['body']['$id']);
$webhook = $this->getLastRequest();
$signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
- $this->assertEquals($webhook['method'], 'POST');
- $this->assertEquals($webhook['headers']['Content-Type'], 'application/json');
- $this->assertEquals($webhook['headers']['User-Agent'], 'Appwrite-Server vdev. Please report abuse at security@appwrite.io');
+ $this->assertEquals('POST', $webhook['method']);
+ $this->assertEquals('application/json', $webhook['headers']['Content-Type']);
+ $this->assertEquals('Appwrite-Server vdev. Please report abuse at security@appwrite.io', $webhook['headers']['User-Agent']);
$this->assertStringContainsString('databases.' . $databaseId . '.collections.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
$this->assertStringContainsString('databases.' . $databaseId . '.collections.*.update', $webhook['headers']['X-Appwrite-Webhook-Events']);
$this->assertStringContainsString("databases.{$databaseId}.collections.{$id}", $webhook['headers']['X-Appwrite-Webhook-Events']);
@@ -55,9 +56,9 @@ class WebhooksCustomServerTest extends Scope
$this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Signature'], $signatureExpected);
$this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Id'] ?? '', $this->getProject()['webhookId']);
$this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Project-Id'] ?? '', $this->getProject()['$id']);
- $this->assertEquals(empty($webhook['headers']['X-Appwrite-Webhook-User-Id'] ?? ''), true);
+ $this->assertTrue(empty($webhook['headers']['X-Appwrite-Webhook-User-Id'] ?? ''));
$this->assertNotEmpty($webhook['data']['$id']);
- $this->assertEquals($webhook['data']['name'], 'Actors1');
+ $this->assertEquals('Actors1', $webhook['data']['name']);
$this->assertIsArray($webhook['data']['$permissions']);
$this->assertCount(4, $webhook['data']['$permissions']);
@@ -84,8 +85,8 @@ class WebhooksCustomServerTest extends Scope
]);
$indexKey = $index['body']['key'];
- $this->assertEquals($index['headers']['status-code'], 202);
- $this->assertEquals($index['body']['key'], 'fullname');
+ $this->assertEquals(202, $index['headers']['status-code']);
+ $this->assertEquals('fullname', $index['body']['key']);
// wait for database worker to create index
sleep(5);
@@ -93,9 +94,9 @@ class WebhooksCustomServerTest extends Scope
$webhook = $this->getLastRequest();
$signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
- $this->assertEquals($webhook['method'], 'POST');
- $this->assertEquals($webhook['headers']['Content-Type'], 'application/json');
- $this->assertEquals($webhook['headers']['User-Agent'], 'Appwrite-Server vdev. Please report abuse at security@appwrite.io');
+ $this->assertEquals('POST', $webhook['method']);
+ $this->assertEquals('application/json', $webhook['headers']['Content-Type']);
+ $this->assertEquals('Appwrite-Server vdev. Please report abuse at security@appwrite.io', $webhook['headers']['User-Agent']);
$this->assertStringContainsString('databases.' . $databaseId . '.collections.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
$this->assertStringContainsString('databases.' . $databaseId . '.collections.*.indexes.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
$this->assertStringContainsString('databases.' . $databaseId . '.collections.*.indexes.*.create', $webhook['headers']['X-Appwrite-Webhook-Events']);
@@ -105,7 +106,7 @@ class WebhooksCustomServerTest extends Scope
$this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Signature'], $signatureExpected);
$this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Id'] ?? '', $this->getProject()['webhookId']);
$this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Project-Id'] ?? '', $this->getProject()['$id']);
- $this->assertEquals(empty($webhook['headers']['X-Appwrite-Webhook-User-Id'] ?? ''), true);
+ $this->assertTrue(empty($webhook['headers']['X-Appwrite-Webhook-User-Id'] ?? ''));
// Remove index
$this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/collections/' . $data['actorsId'] . '/indexes/' . $index['body']['key'], array_merge([
@@ -119,8 +120,8 @@ class WebhooksCustomServerTest extends Scope
$signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
// $this->assertEquals($webhook['method'], 'DELETE');
- $this->assertEquals($webhook['headers']['Content-Type'], 'application/json');
- $this->assertEquals($webhook['headers']['User-Agent'], 'Appwrite-Server vdev. Please report abuse at security@appwrite.io');
+ $this->assertEquals('application/json', $webhook['headers']['Content-Type']);
+ $this->assertEquals('Appwrite-Server vdev. Please report abuse at security@appwrite.io', $webhook['headers']['User-Agent']);
$this->assertStringContainsString('databases.' . $databaseId . '.collections.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
$this->assertStringContainsString('databases.' . $databaseId . '.collections.*.indexes.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
$this->assertStringContainsString('databases.' . $databaseId . '.collections.*.indexes.*.update', $webhook['headers']['X-Appwrite-Webhook-Events']);
@@ -130,7 +131,7 @@ class WebhooksCustomServerTest extends Scope
$this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Signature'], $signatureExpected);
$this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Id'] ?? '', $this->getProject()['webhookId']);
$this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Project-Id'] ?? '', $this->getProject()['$id']);
- $this->assertEquals(empty($webhook['headers']['X-Appwrite-Webhook-User-Id'] ?? ''), true);
+ $this->assertTrue(empty($webhook['headers']['X-Appwrite-Webhook-User-Id'] ?? ''));
return $data;
}
@@ -172,7 +173,7 @@ class WebhooksCustomServerTest extends Scope
$id = $actors['body']['$id'];
- $this->assertEquals($actors['headers']['status-code'], 201);
+ $this->assertEquals(201, $actors['headers']['status-code']);
$this->assertNotEmpty($actors['body']['$id']);
$actors = $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/collections/' . $actors['body']['$id'], array_merge([
@@ -181,14 +182,14 @@ class WebhooksCustomServerTest extends Scope
'x-appwrite-key' => $this->getProject()['apiKey']
]), []);
- $this->assertEquals($actors['headers']['status-code'], 204);
+ $this->assertEquals(204, $actors['headers']['status-code']);
$webhook = $this->getLastRequest();
$signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
- $this->assertEquals($webhook['method'], 'POST');
- $this->assertEquals($webhook['headers']['Content-Type'], 'application/json');
- $this->assertEquals($webhook['headers']['User-Agent'], 'Appwrite-Server vdev. Please report abuse at security@appwrite.io');
+ $this->assertEquals('POST', $webhook['method']);
+ $this->assertEquals('application/json', $webhook['headers']['Content-Type']);
+ $this->assertEquals('Appwrite-Server vdev. Please report abuse at security@appwrite.io', $webhook['headers']['User-Agent']);
$this->assertStringContainsString('databases.' . $databaseId . '.collections.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
$this->assertStringContainsString('databases.' . $databaseId . '.collections.*.delete', $webhook['headers']['X-Appwrite-Webhook-Events']);
$this->assertStringContainsString("databases.{$databaseId}.collections.{$id}", $webhook['headers']['X-Appwrite-Webhook-Events']);
@@ -196,9 +197,195 @@ class WebhooksCustomServerTest extends Scope
$this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Signature'], $signatureExpected);
$this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Id'] ?? '', $this->getProject()['webhookId']);
$this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Project-Id'] ?? '', $this->getProject()['$id']);
- $this->assertEquals(empty($webhook['headers']['X-Appwrite-Webhook-User-Id'] ?? ''), true);
+ $this->assertTrue(empty($webhook['headers']['X-Appwrite-Webhook-User-Id'] ?? ''));
$this->assertNotEmpty($webhook['data']['$id']);
- $this->assertEquals($webhook['data']['name'], 'Demo');
+ $this->assertEquals('Demo', $webhook['data']['name']);
+ $this->assertIsArray($webhook['data']['$permissions']);
+ $this->assertCount(4, $webhook['data']['$permissions']);
+
+ return [];
+ }
+
+ // Table APIs
+ /**
+ * @depends testCreateColumns
+ */
+ public function testUpdateTable($data): array
+ {
+ $id = $data['actorsId'];
+ $databaseId = $data['databaseId'];
+
+ /**
+ * Test for SUCCESS
+ */
+ $actors = $this->client->call(Client::METHOD_PUT, '/databases/' . $databaseId . '/tables/' . $id, array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'name' => 'Actors1',
+ 'rowSecurity' => true,
+ ]);
+
+ $this->assertEquals(200, $actors['headers']['status-code']);
+ $this->assertNotEmpty($actors['body']['$id']);
+
+ $webhook = $this->getLastRequest();
+ $signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
+
+ $this->assertEquals('POST', $webhook['method']);
+ $this->assertEquals('application/json', $webhook['headers']['Content-Type']);
+ $this->assertEquals('Appwrite-Server vdev. Please report abuse at security@appwrite.io', $webhook['headers']['User-Agent']);
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*.update', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$id}", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$id}.update", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Signature'], $signatureExpected);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Id'] ?? '', $this->getProject()['webhookId']);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Project-Id'] ?? '', $this->getProject()['$id']);
+ $this->assertEmpty($webhook['headers']['X-Appwrite-Webhook-User-Id'] ?? '');
+ $this->assertNotEmpty($webhook['data']['$id']);
+ $this->assertEquals('Actors1', $webhook['data']['name']);
+ $this->assertIsArray($webhook['data']['$permissions']);
+ $this->assertCount(4, $webhook['data']['$permissions']);
+
+ return array_merge(['actorsId' => $actors['body']['$id']]);
+ }
+
+ /**
+ * @depends testCreateColumns
+ */
+ public function testCreateDeleteColumnIndexes($data): array
+ {
+ $actorsId = $data['actorsId'];
+ $databaseId = $data['databaseId'];
+
+ $index = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables/' . $data['actorsId'] . '/indexes', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'key' => 'fullname',
+ 'type' => 'key',
+ 'columns' => ['lastName', 'firstName'],
+ 'orders' => ['ASC', 'ASC'],
+ ]);
+
+ $this->assertEquals(202, $index['headers']['status-code']);
+ $this->assertEquals('fullname', $index['body']['key']);
+
+ // wait for database worker to create index
+ sleep(5);
+
+ $webhook = $this->getLastRequest();
+ $signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
+
+ $this->assertEquals('POST', $webhook['method']);
+ $this->assertEquals('application/json', $webhook['headers']['Content-Type']);
+ $this->assertEquals('Appwrite-Server vdev. Please report abuse at security@appwrite.io', $webhook['headers']['User-Agent']);
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*.indexes.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*.indexes.*.create', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}.indexes.*", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}.indexes.*.create", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Signature'], $signatureExpected);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Id'] ?? '', $this->getProject()['webhookId']);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Project-Id'] ?? '', $this->getProject()['$id']);
+ $this->assertTrue(empty($webhook['headers']['X-Appwrite-Webhook-User-Id'] ?? ''));
+
+ // Remove index
+ $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $data['actorsId'] . '/indexes/' . $index['body']['key'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ // // wait for database worker to remove index
+ $webhook = $this->getLastRequest();
+ $signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
+
+ // $this->assertEquals($webhook['method'], 'DELETE');
+ $this->assertEquals('application/json', $webhook['headers']['Content-Type']);
+ $this->assertEquals('Appwrite-Server vdev. Please report abuse at security@appwrite.io', $webhook['headers']['User-Agent']);
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*.indexes.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*.indexes.*.update', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}.indexes.*", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$actorsId}.indexes.*.update", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Signature'], $signatureExpected);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Id'] ?? '', $this->getProject()['webhookId']);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Project-Id'] ?? '', $this->getProject()['$id']);
+ $this->assertTrue(empty($webhook['headers']['X-Appwrite-Webhook-User-Id'] ?? ''));
+
+ return $data;
+ }
+
+ public function testDeleteTable(): array
+ {
+ /**
+ * Create database
+ */
+ $database = $this->client->call(Client::METHOD_POST, '/databases', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ], $this->getHeaders()), [
+ 'databaseId' => ID::unique(),
+ 'name' => 'Actors DB',
+ ]);
+
+ $databaseId = $database['body']['$id'];
+
+ /**
+ * Test for SUCCESS
+ */
+ $actors = $this->client->call(Client::METHOD_POST, '/databases/' . $databaseId . '/tables', array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]), [
+ 'tableId' => ID::unique(),
+ 'name' => 'Demo',
+ 'permissions' => [
+ Permission::read(Role::any()),
+ Permission::create(Role::any()),
+ Permission::update(Role::any()),
+ Permission::delete(Role::any()),
+ ],
+ 'rowSecurity' => true,
+ ]);
+
+ $id = $actors['body']['$id'];
+
+ $this->assertEquals(201, $actors['headers']['status-code']);
+ $this->assertNotEmpty($actors['body']['$id']);
+
+ $actors = $this->client->call(Client::METHOD_DELETE, '/databases/' . $databaseId . '/tables/' . $actors['body']['$id'], array_merge([
+ 'content-type' => 'application/json',
+ 'x-appwrite-project' => $this->getProject()['$id'],
+ 'x-appwrite-key' => $this->getProject()['apiKey']
+ ]));
+
+ $this->assertEquals(204, $actors['headers']['status-code']);
+
+ $webhook = $this->getLastRequest();
+ $signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
+
+ $this->assertEquals('POST', $webhook['method']);
+ $this->assertEquals('application/json', $webhook['headers']['Content-Type']);
+ $this->assertEquals('Appwrite-Server vdev. Please report abuse at security@appwrite.io', $webhook['headers']['User-Agent']);
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString('databases.' . $databaseId . '.tables.*.delete', $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$id}", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertStringContainsString("databases.{$databaseId}.tables.{$id}.delete", $webhook['headers']['X-Appwrite-Webhook-Events']);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Signature'], $signatureExpected);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Id'] ?? '', $this->getProject()['webhookId']);
+ $this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Project-Id'] ?? '', $this->getProject()['$id']);
+ $this->assertEmpty($webhook['headers']['X-Appwrite-Webhook-User-Id'] ?? '');
+ $this->assertNotEmpty($webhook['data']['$id']);
+ $this->assertEquals('Demo', $webhook['data']['name']);
$this->assertIsArray($webhook['data']['$permissions']);
$this->assertCount(4, $webhook['data']['$permissions']);
@@ -224,7 +411,7 @@ class WebhooksCustomServerTest extends Scope
'name' => $name,
]);
- $this->assertEquals($user['headers']['status-code'], 201);
+ $this->assertEquals(201, $user['headers']['status-code']);
$this->assertNotEmpty($user['body']['$id']);
$id = $user['body']['$id'];
@@ -232,9 +419,9 @@ class WebhooksCustomServerTest extends Scope
$webhook = $this->getLastRequest();
$signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
- $this->assertEquals($webhook['method'], 'POST');
- $this->assertEquals($webhook['headers']['Content-Type'], 'application/json');
- $this->assertEquals($webhook['headers']['User-Agent'], 'Appwrite-Server vdev. Please report abuse at security@appwrite.io');
+ $this->assertEquals('POST', $webhook['method']);
+ $this->assertEquals('application/json', $webhook['headers']['Content-Type']);
+ $this->assertEquals('Appwrite-Server vdev. Please report abuse at security@appwrite.io', $webhook['headers']['User-Agent']);
$this->assertStringContainsString('users.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
$this->assertStringContainsString('users.*.create', $webhook['headers']['X-Appwrite-Webhook-Events']);
$this->assertStringContainsString("users.{$id}", $webhook['headers']['X-Appwrite-Webhook-Events']);
@@ -245,11 +432,11 @@ class WebhooksCustomServerTest extends Scope
$this->assertEquals(empty($webhook['headers']['X-Appwrite-Webhook-User-Id'] ?? ''), ('server' === $this->getSide()));
$this->assertNotEmpty($webhook['data']['$id']);
$this->assertEquals($webhook['data']['name'], $name);
- $this->assertEquals(true, (new DatetimeValidator())->isValid($webhook['data']['registration']));
- $this->assertEquals($webhook['data']['status'], true);
+ $this->assertTrue((new DatetimeValidator())->isValid($webhook['data']['registration']));
+ $this->assertTrue($webhook['data']['status']);
$this->assertEquals($webhook['data']['email'], $email);
- $this->assertEquals($webhook['data']['emailVerification'], false);
- $this->assertEquals($webhook['data']['prefs'], []);
+ $this->assertFalse($webhook['data']['emailVerification']);
+ $this->assertEquals([], $webhook['data']['prefs']);
/**
* Test for FAILURE
@@ -274,15 +461,15 @@ class WebhooksCustomServerTest extends Scope
'prefs' => ['a' => 'b']
]);
- $this->assertEquals($user['headers']['status-code'], 200);
- $this->assertEquals($user['body']['a'], 'b');
+ $this->assertEquals(200, $user['headers']['status-code']);
+ $this->assertEquals('b', $user['body']['a']);
$webhook = $this->getLastRequest();
$signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
- $this->assertEquals($webhook['method'], 'POST');
- $this->assertEquals($webhook['headers']['Content-Type'], 'application/json');
- $this->assertEquals($webhook['headers']['User-Agent'], 'Appwrite-Server vdev. Please report abuse at security@appwrite.io');
+ $this->assertEquals('POST', $webhook['method']);
+ $this->assertEquals('application/json', $webhook['headers']['Content-Type']);
+ $this->assertEquals('Appwrite-Server vdev. Please report abuse at security@appwrite.io', $webhook['headers']['User-Agent']);
$this->assertStringContainsString('users.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
$this->assertStringContainsString('users.*.update', $webhook['headers']['X-Appwrite-Webhook-Events']);
$this->assertStringContainsString('users.*.update.prefs', $webhook['headers']['X-Appwrite-Webhook-Events']);
@@ -293,7 +480,7 @@ class WebhooksCustomServerTest extends Scope
$this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Id'] ?? '', $this->getProject()['webhookId']);
$this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Project-Id'] ?? '', $this->getProject()['$id']);
$this->assertEquals(empty($webhook['headers']['X-Appwrite-Webhook-User-Id'] ?? ''), ('server' === $this->getSide()));
- $this->assertEquals($webhook['data']['a'], 'b');
+ $this->assertEquals('b', $webhook['data']['a']);
return $data;
}
@@ -315,15 +502,15 @@ class WebhooksCustomServerTest extends Scope
'status' => false,
]);
- $this->assertEquals($user['headers']['status-code'], 200);
+ $this->assertEquals(200, $user['headers']['status-code']);
$this->assertNotEmpty($user['body']['$id']);
$webhook = $this->getLastRequest();
$signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
- $this->assertEquals($webhook['method'], 'POST');
- $this->assertEquals($webhook['headers']['Content-Type'], 'application/json');
- $this->assertEquals($webhook['headers']['User-Agent'], 'Appwrite-Server vdev. Please report abuse at security@appwrite.io');
+ $this->assertEquals('POST', $webhook['method']);
+ $this->assertEquals('application/json', $webhook['headers']['Content-Type']);
+ $this->assertEquals('Appwrite-Server vdev. Please report abuse at security@appwrite.io', $webhook['headers']['User-Agent']);
$this->assertStringContainsString('users.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
$this->assertStringContainsString('users.*.update', $webhook['headers']['X-Appwrite-Webhook-Events']);
$this->assertStringContainsString('users.*.update.status', $webhook['headers']['X-Appwrite-Webhook-Events']);
@@ -336,11 +523,11 @@ class WebhooksCustomServerTest extends Scope
$this->assertEquals(empty($webhook['headers']['X-Appwrite-Webhook-User-Id'] ?? ''), ('server' === $this->getSide()));
$this->assertNotEmpty($webhook['data']['$id']);
$this->assertEquals($webhook['data']['name'], $data['name']);
- $this->assertEquals(true, (new DatetimeValidator())->isValid($webhook['data']['registration']));
- $this->assertEquals($webhook['data']['status'], false);
+ $this->assertTrue((new DatetimeValidator())->isValid($webhook['data']['registration']));
+ $this->assertFalse($webhook['data']['status']);
$this->assertEquals($webhook['data']['email'], $data['email']);
- $this->assertEquals($webhook['data']['emailVerification'], false);
- $this->assertEquals($webhook['data']['prefs']['a'], 'b');
+ $this->assertFalse($webhook['data']['emailVerification']);
+ $this->assertEquals('b', $webhook['data']['prefs']['a']);
return $data;
}
@@ -360,14 +547,14 @@ class WebhooksCustomServerTest extends Scope
'x-appwrite-project' => $this->getProject()['$id'],
], $this->getHeaders()));
- $this->assertEquals($user['headers']['status-code'], 204);
+ $this->assertEquals(204, $user['headers']['status-code']);
$webhook = $this->getLastRequest();
$signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
- $this->assertEquals($webhook['method'], 'POST');
- $this->assertEquals($webhook['headers']['Content-Type'], 'application/json');
- $this->assertEquals($webhook['headers']['User-Agent'], 'Appwrite-Server vdev. Please report abuse at security@appwrite.io');
+ $this->assertEquals('POST', $webhook['method']);
+ $this->assertEquals('application/json', $webhook['headers']['Content-Type']);
+ $this->assertEquals('Appwrite-Server vdev. Please report abuse at security@appwrite.io', $webhook['headers']['User-Agent']);
$this->assertStringContainsString('users.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
$this->assertStringContainsString('users.*.delete', $webhook['headers']['X-Appwrite-Webhook-Events']);
$this->assertStringContainsString("users.{$id}", $webhook['headers']['X-Appwrite-Webhook-Events']);
@@ -378,11 +565,11 @@ class WebhooksCustomServerTest extends Scope
$this->assertEquals(empty($webhook['headers']['X-Appwrite-Webhook-User-Id'] ?? ''), ('server' === $this->getSide()));
$this->assertNotEmpty($webhook['data']['$id']);
$this->assertEquals($webhook['data']['name'], $data['name']);
- $this->assertEquals(true, (new DatetimeValidator())->isValid($webhook['data']['registration']));
- $this->assertEquals($webhook['data']['status'], false);
+ $this->assertTrue((new DatetimeValidator())->isValid($webhook['data']['registration']));
+ $this->assertFalse($webhook['data']['status']);
$this->assertEquals($webhook['data']['email'], $data['email']);
- $this->assertEquals($webhook['data']['emailVerification'], false);
- $this->assertEquals($webhook['data']['prefs']['a'], 'b');
+ $this->assertFalse($webhook['data']['emailVerification']);
+ $this->assertEquals('b', $webhook['data']['prefs']['a']);
return $data;
}
@@ -406,15 +593,15 @@ class WebhooksCustomServerTest extends Scope
$id = $function['body']['$id'] ?? '';
- $this->assertEquals($function['headers']['status-code'], 201);
+ $this->assertEquals(201, $function['headers']['status-code']);
$this->assertNotEmpty($function['body']['$id']);
$webhook = $this->getLastRequest();
$signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
- $this->assertEquals($webhook['method'], 'POST');
- $this->assertEquals($webhook['headers']['Content-Type'], 'application/json');
- $this->assertEquals($webhook['headers']['User-Agent'], 'Appwrite-Server vdev. Please report abuse at security@appwrite.io');
+ $this->assertEquals('POST', $webhook['method']);
+ $this->assertEquals('application/json', $webhook['headers']['Content-Type']);
+ $this->assertEquals('Appwrite-Server vdev. Please report abuse at security@appwrite.io', $webhook['headers']['User-Agent']);
$this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Signature'], $signatureExpected);
$this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Id'] ?? '', $this->getProject()['webhookId']);
$this->assertEquals($webhook['headers']['X-Appwrite-Webhook-Project-Id'] ?? '', $this->getProject()['$id']);
@@ -447,7 +634,7 @@ class WebhooksCustomServerTest extends Scope
]
]);
- $this->assertEquals($function['headers']['status-code'], 200);
+ $this->assertEquals(200, $function['headers']['status-code']);
$this->assertEquals($function['body']['$id'], $data['functionId']);
// Create variable
@@ -464,9 +651,9 @@ class WebhooksCustomServerTest extends Scope
$webhook = $this->getLastRequest();
$signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
- $this->assertEquals($webhook['method'], 'POST');
- $this->assertEquals($webhook['headers']['Content-Type'], 'application/json');
- $this->assertEquals($webhook['headers']['User-Agent'], 'Appwrite-Server vdev. Please report abuse at security@appwrite.io');
+ $this->assertEquals('POST', $webhook['method']);
+ $this->assertEquals('application/json', $webhook['headers']['Content-Type']);
+ $this->assertEquals('Appwrite-Server vdev. Please report abuse at security@appwrite.io', $webhook['headers']['User-Agent']);
// $this->assertStringContainsString('functions.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
// $this->assertStringContainsString('functions.*.update', $webhook['headers']['X-Appwrite-Webhook-Events']);
// $this->assertStringContainsString("functions.{$id}", $webhook['headers']['X-Appwrite-Webhook-Events']);
@@ -504,15 +691,15 @@ class WebhooksCustomServerTest extends Scope
$functionId = $data['functionId'] ?? '';
$deploymentId = $deployment['body']['$id'] ?? '';
- $this->assertEquals($deployment['headers']['status-code'], 202);
+ $this->assertEquals(202, $deployment['headers']['status-code']);
$this->assertNotEmpty($deployment['body']['$id']);
$webhook = $this->getLastRequest();
$signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
- $this->assertEquals($webhook['method'], 'POST');
- $this->assertEquals($webhook['headers']['Content-Type'], 'application/json');
- $this->assertEquals($webhook['headers']['User-Agent'], 'Appwrite-Server vdev. Please report abuse at security@appwrite.io');
+ $this->assertEquals('POST', $webhook['method']);
+ $this->assertEquals('application/json', $webhook['headers']['Content-Type']);
+ $this->assertEquals('Appwrite-Server vdev. Please report abuse at security@appwrite.io', $webhook['headers']['User-Agent']);
// $this->assertStringContainsString('functions.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
// $this->assertStringContainsString('functions.*.deployments.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
// $this->assertStringContainsString("functions.*.deployments.{$deploymentId}", $webhook['headers']['X-Appwrite-Webhook-Events']);
@@ -544,7 +731,7 @@ class WebhooksCustomServerTest extends Scope
'x-appwrite-project' => $this->getProject()['$id'],
], $this->getHeaders()), []);
- $this->assertEquals($response['headers']['status-code'], 200);
+ $this->assertEquals(200, $response['headers']['status-code']);
$this->assertNotEmpty($response['body']['$id']);
// Wait for deployment to be built.
@@ -553,9 +740,9 @@ class WebhooksCustomServerTest extends Scope
$webhook = $this->getLastRequest();
$signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
- $this->assertEquals($webhook['method'], 'POST');
- $this->assertEquals($webhook['headers']['Content-Type'], 'application/json');
- $this->assertEquals($webhook['headers']['User-Agent'], 'Appwrite-Server vdev. Please report abuse at security@appwrite.io');
+ $this->assertEquals('POST', $webhook['method']);
+ $this->assertEquals('application/json', $webhook['headers']['Content-Type']);
+ $this->assertEquals('Appwrite-Server vdev. Please report abuse at security@appwrite.io', $webhook['headers']['User-Agent']);
// $this->assertStringContainsString('functions.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
// $this->assertStringContainsString('functions.*.deployments.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
// $this->assertStringContainsString('functions.*.deployments.*.update', $webhook['headers']['X-Appwrite-Webhook-Events']);
@@ -596,14 +783,14 @@ class WebhooksCustomServerTest extends Scope
$executionId = $execution['body']['$id'] ?? '';
- $this->assertEquals($execution['headers']['status-code'], 202);
+ $this->assertEquals(202, $execution['headers']['status-code']);
$this->assertNotEmpty($execution['body']['$id']);
$webhook = $this->getLastRequest();
$signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
- $this->assertEquals($webhook['method'], 'POST');
- $this->assertEquals($webhook['headers']['Content-Type'], 'application/json');
- $this->assertEquals($webhook['headers']['User-Agent'], 'Appwrite-Server vdev. Please report abuse at security@appwrite.io');
+ $this->assertEquals('POST', $webhook['method']);
+ $this->assertEquals('application/json', $webhook['headers']['Content-Type']);
+ $this->assertEquals('Appwrite-Server vdev. Please report abuse at security@appwrite.io', $webhook['headers']['User-Agent']);
// $this->assertStringContainsString('functions.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
// $this->assertStringContainsString('functions.*.executions.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
// $this->assertStringContainsString('functions.*.executions.*.create', $webhook['headers']['X-Appwrite-Webhook-Events']);
@@ -624,9 +811,9 @@ class WebhooksCustomServerTest extends Scope
$webhook = $this->getLastRequest();
$signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
- $this->assertEquals($webhook['method'], 'POST');
- $this->assertEquals($webhook['headers']['Content-Type'], 'application/json');
- $this->assertEquals($webhook['headers']['User-Agent'], 'Appwrite-Server vdev. Please report abuse at security@appwrite.io');
+ $this->assertEquals('POST', $webhook['method']);
+ $this->assertEquals('application/json', $webhook['headers']['Content-Type']);
+ $this->assertEquals('Appwrite-Server vdev. Please report abuse at security@appwrite.io', $webhook['headers']['User-Agent']);
// $this->assertStringContainsString('functions.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
// $this->assertStringContainsString('functions.*.executions.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
// $this->assertStringContainsString('functions.*.executions.*.update', $webhook['headers']['X-Appwrite-Webhook-Events']);
@@ -663,15 +850,15 @@ class WebhooksCustomServerTest extends Scope
'x-appwrite-project' => $this->getProject()['$id'],
], $this->getHeaders()));
- $this->assertEquals($deployment['headers']['status-code'], 204);
+ $this->assertEquals(204, $deployment['headers']['status-code']);
$this->assertEmpty($deployment['body']);
$webhook = $this->getLastRequest();
$signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
- $this->assertEquals($webhook['method'], 'POST');
- $this->assertEquals($webhook['headers']['Content-Type'], 'application/json');
- $this->assertEquals($webhook['headers']['User-Agent'], 'Appwrite-Server vdev. Please report abuse at security@appwrite.io');
+ $this->assertEquals('POST', $webhook['method']);
+ $this->assertEquals('application/json', $webhook['headers']['Content-Type']);
+ $this->assertEquals('Appwrite-Server vdev. Please report abuse at security@appwrite.io', $webhook['headers']['User-Agent']);
// $this->assertStringContainsString('functions.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
// $this->assertStringContainsString('functions.*.deployments.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
// $this->assertStringContainsString('functions.*.deployments.*.delete', $webhook['headers']['X-Appwrite-Webhook-Events']);
@@ -714,9 +901,9 @@ class WebhooksCustomServerTest extends Scope
$webhook = $this->getLastRequest();
$signatureExpected = self::getWebhookSignature($webhook, $this->getProject()['signatureKey']);
- $this->assertEquals($webhook['method'], 'POST');
- $this->assertEquals($webhook['headers']['Content-Type'], 'application/json');
- $this->assertEquals($webhook['headers']['User-Agent'], 'Appwrite-Server vdev. Please report abuse at security@appwrite.io');
+ $this->assertEquals('POST', $webhook['method']);
+ $this->assertEquals('application/json', $webhook['headers']['Content-Type']);
+ $this->assertEquals('Appwrite-Server vdev. Please report abuse at security@appwrite.io', $webhook['headers']['User-Agent']);
// $this->assertStringContainsString('functions.*', $webhook['headers']['X-Appwrite-Webhook-Events']);
// $this->assertStringContainsString('functions.*.delete', $webhook['headers']['X-Appwrite-Webhook-Events']);
// $this->assertStringContainsString("functions.{$id}", $webhook['headers']['X-Appwrite-Webhook-Events']);
diff --git a/tests/unit/Event/EventTest.php b/tests/unit/Event/EventTest.php
index c852cf2757..d5936e4b8f 100644
--- a/tests/unit/Event/EventTest.php
+++ b/tests/unit/Event/EventTest.php
@@ -93,57 +93,57 @@ class EventTest extends TestCase
$this->assertContains('users.*.update', $event);
$this->assertContains('users.*', $event);
- $event = Event::generateEvents('collections.[collectionId].documents.[documentId].create', [
- 'collectionId' => 'chapters',
- 'documentId' => 'prolog',
+ $event = Event::generateEvents('tables.[tableId].rows.[rowId].create', [
+ 'tableId' => 'chapters',
+ 'rowId' => 'prolog',
]);
$this->assertCount(10, $event);
- $this->assertContains('collections.chapters.documents.prolog.create', $event);
- $this->assertContains('collections.chapters.documents.prolog', $event);
- $this->assertContains('collections.chapters.documents.*.create', $event);
- $this->assertContains('collections.chapters.documents.*', $event);
- $this->assertContains('collections.chapters', $event);
- $this->assertContains('collections.*.documents.prolog.create', $event);
- $this->assertContains('collections.*.documents.prolog', $event);
- $this->assertContains('collections.*.documents.*.create', $event);
- $this->assertContains('collections.*.documents.*', $event);
- $this->assertContains('collections.*', $event);
+ $this->assertContains('tables.chapters.rows.prolog.create', $event);
+ $this->assertContains('tables.chapters.rows.prolog', $event);
+ $this->assertContains('tables.chapters.rows.*.create', $event);
+ $this->assertContains('tables.chapters.rows.*', $event);
+ $this->assertContains('tables.chapters', $event);
+ $this->assertContains('tables.*.rows.prolog.create', $event);
+ $this->assertContains('tables.*.rows.prolog', $event);
+ $this->assertContains('tables.*.rows.*.create', $event);
+ $this->assertContains('tables.*.rows.*', $event);
+ $this->assertContains('tables.*', $event);
- $event = Event::generateEvents('databases.[databaseId].collections.[collectionId].documents.[documentId].create', [
+ $event = Event::generateEvents('databases.[databaseId].tables.[tableId].rows.[rowId].create', [
'databaseId' => 'chaptersDB',
- 'collectionId' => 'chapters',
- 'documentId' => 'prolog',
+ 'tableId' => 'chapters',
+ 'rowId' => 'prolog',
]);
$this->assertCount(22, $event);
- $this->assertContains('databases.chaptersDB.collections.chapters.documents.prolog.create', $event);
- $this->assertContains('databases.chaptersDB.collections.chapters.documents.prolog', $event);
- $this->assertContains('databases.chaptersDB.collections.chapters.documents.*.create', $event);
- $this->assertContains('databases.chaptersDB.collections.chapters.documents.*', $event);
- $this->assertContains('databases.chaptersDB.collections.chapters', $event);
- $this->assertContains('databases.chaptersDB.collections.*.documents.prolog.create', $event);
- $this->assertContains('databases.chaptersDB.collections.*.documents.prolog', $event);
- $this->assertContains('databases.chaptersDB.collections.*', $event);
+ $this->assertContains('databases.chaptersDB.tables.chapters.rows.prolog.create', $event);
+ $this->assertContains('databases.chaptersDB.tables.chapters.rows.prolog', $event);
+ $this->assertContains('databases.chaptersDB.tables.chapters.rows.*.create', $event);
+ $this->assertContains('databases.chaptersDB.tables.chapters.rows.*', $event);
+ $this->assertContains('databases.chaptersDB.tables.chapters', $event);
+ $this->assertContains('databases.chaptersDB.tables.*.rows.prolog.create', $event);
+ $this->assertContains('databases.chaptersDB.tables.*.rows.prolog', $event);
+ $this->assertContains('databases.chaptersDB.tables.*', $event);
$this->assertContains('databases.chaptersDB', $event);
- $this->assertContains('databases.*.collections.chapters.documents.prolog.create', $event);
- $this->assertContains('databases.*.collections.chapters.documents.prolog', $event);
- $this->assertContains('databases.*.collections.chapters', $event);
- $this->assertContains('databases.*.collections.*.documents.*.create', $event);
- $this->assertContains('databases.*.collections.*.documents.*', $event);
- $this->assertContains('databases.*.collections.*', $event);
+ $this->assertContains('databases.*.tables.chapters.rows.prolog.create', $event);
+ $this->assertContains('databases.*.tables.chapters.rows.prolog', $event);
+ $this->assertContains('databases.*.tables.chapters', $event);
+ $this->assertContains('databases.*.tables.*.rows.*.create', $event);
+ $this->assertContains('databases.*.tables.*.rows.*', $event);
+ $this->assertContains('databases.*.tables.*', $event);
$this->assertContains('databases.*', $event);
- $this->assertContains('databases.*.collections.*.documents.prolog', $event);
- $this->assertContains('databases.*.collections.*.documents.prolog.create', $event);
- $this->assertContains('databases.*.collections.chapters.documents.*', $event);
- $this->assertContains('databases.*.collections.chapters.documents.*.create', $event);
- $this->assertContains('databases.chaptersDB.collections.*.documents.*', $event);
- $this->assertContains('databases.chaptersDB.collections.*.documents.*.create', $event);
+ $this->assertContains('databases.*.tables.*.rows.prolog', $event);
+ $this->assertContains('databases.*.tables.*.rows.prolog.create', $event);
+ $this->assertContains('databases.*.tables.chapters.rows.*', $event);
+ $this->assertContains('databases.*.tables.chapters.rows.*.create', $event);
+ $this->assertContains('databases.chaptersDB.tables.*.rows.*', $event);
+ $this->assertContains('databases.chaptersDB.tables.*.rows.*.create', $event);
try {
- $event = Event::generateEvents('collections.[collectionId].documents.[documentId].create', [
- 'collectionId' => 'chapters'
+ $event = Event::generateEvents('tables.[tableId].rows.[rowId].create', [
+ 'tableId' => 'chapters'
]);
$this->fail();
} catch (\Throwable $th) {
@@ -151,7 +151,7 @@ class EventTest extends TestCase
}
try {
- $event = Event::generateEvents('collections.[collectionId].documents.[documentId].create');
+ $event = Event::generateEvents('tables.[tableId].rows.[rowId].create');
$this->fail();
} catch (\Throwable $th) {
$this->assertInstanceOf(InvalidArgumentException::class, $th, 'An invalid exception was thrown');
diff --git a/tests/unit/Event/MockPublisher.php b/tests/unit/Event/MockPublisher.php
index 54fcc89358..0b812e7032 100644
--- a/tests/unit/Event/MockPublisher.php
+++ b/tests/unit/Event/MockPublisher.php
@@ -7,7 +7,7 @@ use Utopia\Queue\Queue;
class MockPublisher implements Publisher
{
- private $events = [];
+ private array $events = [];
public function enqueue(Queue $queue, array $payload): bool
{
diff --git a/tests/unit/Event/Validator/EventValidatorTest.php b/tests/unit/Event/Validator/EventValidatorTest.php
index e9f652adeb..6885d20bfb 100644
--- a/tests/unit/Event/Validator/EventValidatorTest.php
+++ b/tests/unit/Event/Validator/EventValidatorTest.php
@@ -29,27 +29,27 @@ class EventValidatorTest extends TestCase
$this->assertTrue($this->object->isValid('users.*.update.email'));
$this->assertTrue($this->object->isValid('users.*.update'));
$this->assertTrue($this->object->isValid('users.*'));
- $this->assertTrue($this->object->isValid('databases.books.collections.chapters.documents.prolog.create'));
- $this->assertTrue($this->object->isValid('databases.books.collections.chapters.documents.prolog'));
- $this->assertTrue($this->object->isValid('databases.books.collections.chapters.documents.*.create'));
- $this->assertTrue($this->object->isValid('databases.books.collections.chapters.documents.*'));
- $this->assertTrue($this->object->isValid('databases.books.collections.*.documents.prolog.create'));
- $this->assertTrue($this->object->isValid('databases.books.collections.*.documents.prolog'));
- $this->assertTrue($this->object->isValid('databases.books.collections.*.documents.*.create'));
- $this->assertTrue($this->object->isValid('databases.books.collections.*.documents.*'));
- $this->assertTrue($this->object->isValid('databases.*.collections.chapters.documents.prolog.create'));
- $this->assertTrue($this->object->isValid('databases.*.collections.chapters.documents.prolog'));
- $this->assertTrue($this->object->isValid('databases.*.collections.chapters.documents.*.create'));
- $this->assertTrue($this->object->isValid('databases.*.collections.chapters.documents.*'));
- $this->assertTrue($this->object->isValid('databases.*.collections.*.documents.prolog.create'));
- $this->assertTrue($this->object->isValid('databases.*.collections.*.documents.prolog'));
- $this->assertTrue($this->object->isValid('databases.*.collections.*.documents.*.create'));
- $this->assertTrue($this->object->isValid('databases.*.collections.*.documents.*'));
- $this->assertTrue($this->object->isValid('databases.*.collections.*'));
+ $this->assertTrue($this->object->isValid('databases.books.tables.chapters.rows.prolog.create'));
+ $this->assertTrue($this->object->isValid('databases.books.tables.chapters.rows.prolog'));
+ $this->assertTrue($this->object->isValid('databases.books.tables.chapters.rows.*.create'));
+ $this->assertTrue($this->object->isValid('databases.books.tables.chapters.rows.*'));
+ $this->assertTrue($this->object->isValid('databases.books.tables.*.rows.prolog.create'));
+ $this->assertTrue($this->object->isValid('databases.books.tables.*.rows.prolog'));
+ $this->assertTrue($this->object->isValid('databases.books.tables.*.rows.*.create'));
+ $this->assertTrue($this->object->isValid('databases.books.tables.*.rows.*'));
+ $this->assertTrue($this->object->isValid('databases.*.tables.chapters.rows.prolog.create'));
+ $this->assertTrue($this->object->isValid('databases.*.tables.chapters.rows.prolog'));
+ $this->assertTrue($this->object->isValid('databases.*.tables.chapters.rows.*.create'));
+ $this->assertTrue($this->object->isValid('databases.*.tables.chapters.rows.*'));
+ $this->assertTrue($this->object->isValid('databases.*.tables.*.rows.prolog.create'));
+ $this->assertTrue($this->object->isValid('databases.*.tables.*.rows.prolog'));
+ $this->assertTrue($this->object->isValid('databases.*.tables.*.rows.*.create'));
+ $this->assertTrue($this->object->isValid('databases.*.tables.*.rows.*'));
+ $this->assertTrue($this->object->isValid('databases.*.tables.*'));
$this->assertTrue($this->object->isValid('databases.*'));
$this->assertTrue($this->object->isValid('databases.books'));
- $this->assertTrue($this->object->isValid('databases.books.collections.chapters'));
- $this->assertTrue($this->object->isValid('databases.books.collections.*'));
+ $this->assertTrue($this->object->isValid('databases.books.tables.chapters'));
+ $this->assertTrue($this->object->isValid('databases.books.tables.*'));
$this->assertTrue($this->object->isValid('functions.*'));
$this->assertTrue($this->object->isValid('buckets.*'));
$this->assertTrue($this->object->isValid('teams.*'));
@@ -63,9 +63,9 @@ class EventValidatorTest extends TestCase
$this->assertFalse($this->object->isValid(null));
$this->assertFalse($this->object->isValid(''));
$this->assertFalse($this->object->isValid('unknown.*'));
- $this->assertFalse($this->object->isValid('collections'));
- $this->assertFalse($this->object->isValid('collections.*.unknown'));
- $this->assertFalse($this->object->isValid('collections.*.documents.*.unknown'));
+ $this->assertFalse($this->object->isValid('tables'));
+ $this->assertFalse($this->object->isValid('tables.*.unknown'));
+ $this->assertFalse($this->object->isValid('tables.*.rows.*.unknown'));
$this->assertFalse($this->object->isValid('users.torsten.unknown'));
$this->assertFalse($this->object->isValid('users.torsten.delete.email'));
$this->assertFalse($this->object->isValid('teams.*.memberships.*.update.unknown'));
diff --git a/tests/unit/Event/Validator/FunctionEventValidatorTest.php b/tests/unit/Event/Validator/FunctionEventValidatorTest.php
index ea59f6771a..9b6e05b9f7 100644
--- a/tests/unit/Event/Validator/FunctionEventValidatorTest.php
+++ b/tests/unit/Event/Validator/FunctionEventValidatorTest.php
@@ -29,27 +29,27 @@ class FunctionEventValidatorTest extends TestCase
$this->assertTrue($this->object->isValid('users.*.update.email'));
$this->assertTrue($this->object->isValid('users.*.update'));
$this->assertTrue($this->object->isValid('users.*'));
- $this->assertTrue($this->object->isValid('databases.books.collections.chapters.documents.prolog.create'));
- $this->assertTrue($this->object->isValid('databases.books.collections.chapters.documents.prolog'));
- $this->assertTrue($this->object->isValid('databases.books.collections.chapters.documents.*.create'));
- $this->assertTrue($this->object->isValid('databases.books.collections.chapters.documents.*'));
- $this->assertTrue($this->object->isValid('databases.books.collections.*.documents.prolog.create'));
- $this->assertTrue($this->object->isValid('databases.books.collections.*.documents.prolog'));
- $this->assertTrue($this->object->isValid('databases.books.collections.*.documents.*.create'));
- $this->assertTrue($this->object->isValid('databases.books.collections.*.documents.*'));
- $this->assertTrue($this->object->isValid('databases.*.collections.chapters.documents.prolog.create'));
- $this->assertTrue($this->object->isValid('databases.*.collections.chapters.documents.prolog'));
- $this->assertTrue($this->object->isValid('databases.*.collections.chapters.documents.*.create'));
- $this->assertTrue($this->object->isValid('databases.*.collections.chapters.documents.*'));
- $this->assertTrue($this->object->isValid('databases.*.collections.*.documents.prolog.create'));
- $this->assertTrue($this->object->isValid('databases.*.collections.*.documents.prolog'));
- $this->assertTrue($this->object->isValid('databases.*.collections.*.documents.*.create'));
- $this->assertTrue($this->object->isValid('databases.*.collections.*.documents.*'));
- $this->assertTrue($this->object->isValid('databases.*.collections.*'));
+ $this->assertTrue($this->object->isValid('databases.books.tables.chapters.rows.prolog.create'));
+ $this->assertTrue($this->object->isValid('databases.books.tables.chapters.rows.prolog'));
+ $this->assertTrue($this->object->isValid('databases.books.tables.chapters.rows.*.create'));
+ $this->assertTrue($this->object->isValid('databases.books.tables.chapters.rows.*'));
+ $this->assertTrue($this->object->isValid('databases.books.tables.*.rows.prolog.create'));
+ $this->assertTrue($this->object->isValid('databases.books.tables.*.rows.prolog'));
+ $this->assertTrue($this->object->isValid('databases.books.tables.*.rows.*.create'));
+ $this->assertTrue($this->object->isValid('databases.books.tables.*.rows.*'));
+ $this->assertTrue($this->object->isValid('databases.*.tables.chapters.rows.prolog.create'));
+ $this->assertTrue($this->object->isValid('databases.*.tables.chapters.rows.prolog'));
+ $this->assertTrue($this->object->isValid('databases.*.tables.chapters.rows.*.create'));
+ $this->assertTrue($this->object->isValid('databases.*.tables.chapters.rows.*'));
+ $this->assertTrue($this->object->isValid('databases.*.tables.*.rows.prolog.create'));
+ $this->assertTrue($this->object->isValid('databases.*.tables.*.rows.prolog'));
+ $this->assertTrue($this->object->isValid('databases.*.tables.*.rows.*.create'));
+ $this->assertTrue($this->object->isValid('databases.*.tables.*.rows.*'));
+ $this->assertTrue($this->object->isValid('databases.*.tables.*'));
$this->assertTrue($this->object->isValid('databases.*'));
$this->assertTrue($this->object->isValid('databases.books'));
- $this->assertTrue($this->object->isValid('databases.books.collections.chapters'));
- $this->assertTrue($this->object->isValid('databases.books.collections.*'));
+ $this->assertTrue($this->object->isValid('databases.books.tables.chapters'));
+ $this->assertTrue($this->object->isValid('databases.books.tables.*'));
$this->assertTrue($this->object->isValid('buckets.*'));
$this->assertTrue($this->object->isValid('teams.*'));
$this->assertTrue($this->object->isValid('users.*'));
@@ -62,9 +62,9 @@ class FunctionEventValidatorTest extends TestCase
$this->assertFalse($this->object->isValid(null));
$this->assertFalse($this->object->isValid(''));
$this->assertFalse($this->object->isValid('unknown.*'));
- $this->assertFalse($this->object->isValid('collections'));
- $this->assertFalse($this->object->isValid('collections.*.unknown'));
- $this->assertFalse($this->object->isValid('collections.*.documents.*.unknown'));
+ $this->assertFalse($this->object->isValid('tables'));
+ $this->assertFalse($this->object->isValid('tables.*.unknown'));
+ $this->assertFalse($this->object->isValid('tables.*.rows.*.unknown'));
$this->assertFalse($this->object->isValid('users.torsten.unknown'));
$this->assertFalse($this->object->isValid('users.torsten.delete.email'));
$this->assertFalse($this->object->isValid('teams.*.memberships.*.update.unknown'));
diff --git a/tests/unit/GraphQL/BuilderTest.php b/tests/unit/GraphQL/BuilderTest.php
index d79a104c90..3dd1bcadc7 100644
--- a/tests/unit/GraphQL/BuilderTest.php
+++ b/tests/unit/GraphQL/BuilderTest.php
@@ -22,8 +22,8 @@ class BuilderTest extends TestCase
*/
public function testCreateTypeMapping()
{
- $model = $this->response->getModel(Response::MODEL_COLLECTION);
+ $model = $this->response->getModel(Response::MODEL_TABLE);
$type = Mapper::model(\ucfirst($model->getType()));
- $this->assertEquals('Collection', $type->name);
+ $this->assertEquals('Table', $type->name);
}
}
diff --git a/tests/unit/Network/Validators/OriginTest.php b/tests/unit/Network/Validators/OriginTest.php
index d9bc77c19f..989c06da71 100644
--- a/tests/unit/Network/Validators/OriginTest.php
+++ b/tests/unit/Network/Validators/OriginTest.php
@@ -2,6 +2,7 @@
namespace Tests\Unit\Network\Validators;
+use Appwrite\Network\Platform;
use Appwrite\Network\Validator\Origin;
use PHPUnit\Framework\TestCase;
use Utopia\Database\Helpers\ID;
@@ -14,62 +15,84 @@ class OriginTest extends TestCase
[
'$collection' => ID::custom('platforms'),
'name' => 'Production',
- 'type' => Origin::CLIENT_TYPE_WEB,
+ 'type' => Platform::TYPE_WEB,
'hostname' => 'appwrite.io',
],
[
'$collection' => ID::custom('platforms'),
'name' => 'Development',
- 'type' => Origin::CLIENT_TYPE_WEB,
+ 'type' => Platform::TYPE_WEB,
'hostname' => 'appwrite.test',
],
[
'$collection' => ID::custom('platforms'),
'name' => 'Localhost',
- 'type' => Origin::CLIENT_TYPE_WEB,
+ 'type' => Platform::TYPE_WEB,
'hostname' => 'localhost',
],
[
'$collection' => ID::custom('platforms'),
'name' => 'Flutter',
- 'type' => Origin::CLIENT_TYPE_FLUTTER_WEB,
+ 'type' => Platform::TYPE_FLUTTER_WEB,
'hostname' => 'appwrite.flutter',
],
+ [
+ '$collection' => ID::custom('platforms'),
+ 'name' => 'Expo',
+ 'type' => Platform::TYPE_SCHEME,
+ 'key' => 'exp',
+ ],
+ [
+ '$collection' => ID::custom('platforms'),
+ 'name' => 'Appwrite Callback',
+ 'type' => Platform::TYPE_SCHEME,
+ 'key' => 'appwrite-callback-123',
+ ],
]);
- $this->assertEquals($validator->isValid('https://localhost'), true);
- $this->assertEquals($validator->isValid('http://localhost'), true);
- $this->assertEquals($validator->isValid('http://localhost:80'), true);
+ $this->assertEquals(false, $validator->isValid(''));
+ $this->assertEquals(false, $validator->isValid('/'));
- $this->assertEquals($validator->isValid('https://appwrite.io'), true);
- $this->assertEquals($validator->isValid('http://appwrite.io'), true);
- $this->assertEquals($validator->isValid('http://appwrite.io:80'), true);
+ $this->assertEquals(true, $validator->isValid('https://localhost'));
+ $this->assertEquals(true, $validator->isValid('http://localhost'));
+ $this->assertEquals(true, $validator->isValid('http://localhost:80'));
- $this->assertEquals($validator->isValid('https://appwrite.test'), true);
- $this->assertEquals($validator->isValid('http://appwrite.test'), true);
- $this->assertEquals($validator->isValid('http://appwrite.test:80'), true);
+ $this->assertEquals(true, $validator->isValid('https://appwrite.io'));
+ $this->assertEquals(true, $validator->isValid('http://appwrite.io'));
+ $this->assertEquals(true, $validator->isValid('http://appwrite.io:80'));
- $this->assertEquals($validator->isValid('https://appwrite.flutter'), true);
- $this->assertEquals($validator->isValid('http://appwrite.flutter'), true);
- $this->assertEquals($validator->isValid('http://appwrite.flutter:80'), true);
+ $this->assertEquals(true, $validator->isValid('https://appwrite.test'));
+ $this->assertEquals(true, $validator->isValid('http://appwrite.test'));
+ $this->assertEquals(true, $validator->isValid('http://appwrite.test:80'));
- $this->assertEquals($validator->isValid('https://example.com'), false);
- $this->assertEquals($validator->isValid('http://example.com'), false);
- $this->assertEquals($validator->isValid('http://example.com:80'), false);
+ $this->assertEquals(true, $validator->isValid('https://appwrite.flutter'));
+ $this->assertEquals(true, $validator->isValid('http://appwrite.flutter'));
+ $this->assertEquals(true, $validator->isValid('http://appwrite.flutter:80'));
- $this->assertEquals($validator->isValid('appwrite-ios://com.company.appname'), false);
- $this->assertEquals($validator->getDescription(), 'Invalid Origin. Register your new client (com.company.appname) as a new iOS platform on your project console dashboard');
+ $this->assertEquals(false, $validator->isValid('https://example.com'));
+ $this->assertEquals(false, $validator->isValid('http://example.com'));
+ $this->assertEquals(false, $validator->isValid('http://example.com:80'));
- $this->assertEquals($validator->isValid('appwrite-android://com.company.appname'), false);
- $this->assertEquals($validator->getDescription(), 'Invalid Origin. Register your new client (com.company.appname) as a new Android platform on your project console dashboard');
+ $this->assertEquals(true, $validator->isValid('exp://'));
+ $this->assertEquals(true, $validator->isValid('exp:///'));
+ $this->assertEquals(true, $validator->isValid('exp://index'));
- $this->assertEquals($validator->isValid('appwrite-macos://com.company.appname'), false);
- $this->assertEquals($validator->getDescription(), 'Invalid Origin. Register your new client (com.company.appname) as a new macOS platform on your project console dashboard');
+ $this->assertEquals(true, $validator->isValid('appwrite-callback-123://'));
+ $this->assertEquals(false, $validator->isValid('appwrite-callback-456://'));
- $this->assertEquals($validator->isValid('appwrite-linux://com.company.appname'), false);
- $this->assertEquals($validator->getDescription(), 'Invalid Origin. Register your new client (com.company.appname) as a new Linux platform on your project console dashboard');
+ $this->assertEquals(false, $validator->isValid('appwrite-ios://com.company.appname'));
+ $this->assertEquals('Invalid Origin. Register your new client (com.company.appname) as a new iOS platform on your project console dashboard', $validator->getDescription());
- $this->assertEquals($validator->isValid('appwrite-windows://com.company.appname'), false);
- $this->assertEquals($validator->getDescription(), 'Invalid Origin. Register your new client (com.company.appname) as a new Windows platform on your project console dashboard');
+ $this->assertEquals(false, $validator->isValid('appwrite-android://com.company.appname'));
+ $this->assertEquals('Invalid Origin. Register your new client (com.company.appname) as a new Android platform on your project console dashboard', $validator->getDescription());
+
+ $this->assertEquals(false, $validator->isValid('appwrite-macos://com.company.appname'));
+ $this->assertEquals('Invalid Origin. Register your new client (com.company.appname) as a new macOS platform on your project console dashboard', $validator->getDescription());
+
+ $this->assertEquals(false, $validator->isValid('appwrite-linux://com.company.appname'));
+ $this->assertEquals('Invalid Origin. Register your new client (com.company.appname) as a new Linux platform on your project console dashboard', $validator->getDescription());
+
+ $this->assertEquals(false, $validator->isValid('appwrite-windows://com.company.appname'));
+ $this->assertEquals('Invalid Origin. Register your new client (com.company.appname) as a new Windows platform on your project console dashboard', $validator->getDescription());
}
}