🔖 Feature description

$resp = $DB::updateDocumentBy('db', 'collection', [
    Query.select(['foo', 'bar'])
], {
    'bar': 'bla',
    'splash': 'hash'
});

🎤 Pitch

Alternate way for SELECT statement when Document ID isn't available. Might be slower in terms of a INNER JOIN not looking for _uid as a PRIMARY KEY.

Allows for more natural thinking in programming, and for example, updateDocumentBy APIKey or any other UNIQUE Column, in our case, in a MariaDB Table.

I thought something like this

Thoughts?

👀 Have you spent some time to check if this issue has been raised before?

• I checked and didn't find similar issue

🏢 Have you read the Code of Conduct?

• I have read the Code of Conduct

👟 Reproduction steps

$db->count(
    Audit::COLLECTION, 
    [
        new Query('column1', Query::EQUALS, ['test'],
        new Query('column2', Query::EQUALS, ['a', 'b']
    ]
);

Will produce following conditions in the SQL query:

  AND table_main.column1 = 'test'
  AND table_main.column2 = 'a'
  OR table_main.column2 = 'b'

👍 Expected behavior

AND table_main.column1 = 'test'
AND 
    (
        table_main.column2 = 'a'
        OR table_main.column2 = 'b'
    )

👎 Actual Behavior

see above.

Example from the complete query:

SELECT COUNT(1) as sum 
FROM (
    SELECT 1 
    FROM project_console_internal.audit table_main
    WHERE 1=1 
    AND 1=1 
    AND table_main.resource = :attribute_0_0_resource 
    AND table_main.event = :attribute_1_0_event 
    OR table_main.event = :a
) table_count

🎲 Utopia Database version

Version 0.10.x

🐘 PHP Version

PHP 8.0.x

💻 Operating system

MacOS

🧱 Your Environment

No response

👀 Have you spent some time to check if this issue has been raised before?

• I checked and didn't find similar issue

🏢 Have you read the Code of Conduct?

• I have read the Code of Conduct

In several places in Appwrite, we have to do:

        $filterQueries = Query::groupByType($queries)['filters'];

        $response->dynamic(new Document([
            'users' => $dbForProject->find('users', $queries),
            'total' => $dbForProject->count('users', $filterQueries, APP_LIMIT_COUNT),
        ]), Response::MODEL_USER_LIST);

It would be much cleaner to have Utopia\Database\Database->count() grab only the filters so that the code can be simplified to:

-        $filterQueries = Query::groupByType($queries)['filters'];

        $response->dynamic(new Document([
            'users' => $dbForProject->find('users', $queries),
-            'total' => $dbForProject->count('users', $filterQueries, APP_LIMIT_COUNT),
+            'total' => $dbForProject->count('users', $queries, APP_LIMIT_COUNT),
        ]), Response::MODEL_USER_LIST);

🔖 Feature description

Adapter to support using AWS DynamoDB database.

🎤 Pitch

• DynamoDB is one of the most common highly performant NoSQL database services.

• Backed by the resiliency of AWS, many teams choose to have DynamoDB as their production database.

• Supporting DynamoDB will ensure that our users can use the service seamlessly from within the utopia framework.

• This feature is inline with the maintainer AppWrite's vision to add support for DynamoDB database

  • appwrite/appwrite#3980

• I will be following guide to Add New Database Adapter

  • The official AWS SDK for PHP - https://github.com/aws/aws-sdk-php - will be added as a dependency.

👀 Have you spent some time to check if this issue has been raised before?

• I checked and didn't find similar issue

🏢 Have you read the Code of Conduct?

• I have read the Code of Conduct

Each adapter must implement the getIntLimit() method, but it isn't enforced due to how we interpret $size for integer attributes.

In the case of strings, $size is pretty obvious - the length of the string. However, for integers (and before BIGINT), we just set $size = 0, so this check in createAttribute() would never actually prevent PDO from throwing the database exception:

Options to enforce int limit:

• Check values for getIntLimit() as a filter when creating/updating documents
• Get PDO error codes when size is exceeded and throw a custom Utopia\Database exception

🔖 Feature description

The SQL adapter including Maria/MySQL/SQLite should support the Contains query. I.E. attribute LIKE '%something%'

🎤 Pitch

Forgive me if I missed it somewhere, but I don't see any reason that the SQL connector doesn't already support "Contains" queries. The syntax is well know, supported by all 3 supported SQL engines(and most others), and simple and consistent across all versions of SQL.

So far as I can tell, this would only require changing 1 line of code to provide support, and one or two others to enable that support(instead of rejecting it).

src/Database/Adapter/SQL.php -> bindConditionValue, add:

Query::TYPE_CONTAINS => '%' . $this->escapeWildcards($value) . '%',

Please let me know if there is a reason this isn't already done. It seems so obvious that I can't help but think there is a reason it's not already done, and that I'm the one missing something obvious.

If needed, I'd be happy to clone, modify, and submit a PR.

👀 Have you spent some time to check if this issue has been raised before?

• I checked and didn't find similar issue

🏢 Have you read the Code of Conduct?

• I have read the Code of Conduct

🔖 Feature description

Adding the option to select n items as random.

The implementation would look something like this

$documents = static::getDatabase()->find('movies', [
    Query::random(),
    Query::limit(5),
]);

Or with limit as the random parameter.

$documents = static::getDatabase()->find('movies', [
    Query::random(5),
]);

Adapter are required for:

• MariaDB
• MySQL
• SQLite
• Postgres
• MongoDB.

🎤 Pitch

I first intend to add it as a feature for Appwrite database endpoints.
Also, It can be helpful in games, for example.

👀 Have you spent some time to check if this issue has been raised before?

• I checked and didn't find similar issue

🏢 Have you read the Code of Conduct?

• I have read the Code of Conduct

🔖 Feature description

An adapter for Apache CouchDB

🎤 Pitch

The point of this repository is to provide a "PHP database abstraction library". So, I intend to provide support for CouchDB. You're welcome.

👀 Have you spent some time to check if this issue has been raised before?

• I checked and didn't find similar issue

🏢 Have you read the Code of Conduct?

• I have read the Code of Conduct

👟 Reproduction steps

When I am installing the module for local development, I am getting the issue swoole coroutine client not found despite the the fact it has been installed and present in the vendor
Tried with Utopia-php/swoole as well
Any steps I am missing or is it a bug in the code?

👍 Expected behavior

No error

👎 Actual Behavior

Getting error

🎲 Utopia Database version

Version 0.10.x

🐘 PHP Version

PHP 8.0.x

💻 Operating system

Linux

🧱 Your Environment

No response

👀 Have you spent some time to check if this issue has been raised before?

• I checked and didn't find similar issue

🏢 Have you read the Code of Conduct?

• I have read the Code of Conduct

It would make sense for the Query/Queries Validators in Appwrite to be moved into Utopia so they can be reused.

🔖 Feature description

The last Query Refactor had some changes that could be improved, but we rushed forward due to lack of time.

🎤 Pitch

• #191
• #193
• #192

👀 Have you spent some time to check if this issue has been raised before?

• I checked and didn't find similar issue

🏢 Have you read the Code of Conduct?

• I have read the Code of Conduct

Variadic functions can be confusing. It's much clearer to use arrays instead:

-    public static function getByType(array $queries, string ...$types): array
+    public static function getByType(array $queries, array $types): array

🔖 Feature description

This fields auto generate on insert / update

It can be usefull to force them via data like

{
...otherFields,
"$createdAt": "string or timestamp"
}

🎤 Pitch

In case of migration for others platform, without this we need to inject data directly on MariaDB, or we'll loose this information or if we simply need to change it for any other reason

👀 Have you spent some time to check if this issue has been raised before?

• I checked and didn't find similar issue

🏢 Have you read the Code of Conduct?

• I have read the Code of Conduct

Introduction

GitHub has recently rolled out a public beta for their issue forms feature. This would allow you to create interactive issue templates and validate them 🤯.

Appwrite currently uses the older issue template format. Your task is to create GitHub issue forms for this repository. Please use Appwrite's issue templates as a reference for this PR.

Tasks summary:

• Fork & clone this repository
• Prepare bug report issue form in .github/ISSUE_TEMPLATE/bug.yaml
• Prepare documentation issue form in .github/ISSUE_TEMPLATE/documentation.yaml
• Prepare feature request issue form in .github/ISSUE_TEMPLATE/feature.yaml
• Push changes to master and test issue forms on your fork
• Submit pull request

If you need any help, reach out to us on our Discord server.

Are you ready to work on this issue? 🤔 Let us know, and we will assign it to you 😊

Happy Appwriting!