@flarum/cli 2.0.0-beta.9 → 3.0.0

package/php-subsystem/vendor/nikic/php-parser/lib/PhpParser/Token.php

@@ -0,0 +1,18 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser;
+
+/**
+ * A PHP token. On PHP 8.0 this extends from PhpToken.
+ */
+class Token extends Internal\TokenPolyfill {
+    /** Get (exclusive) zero-based end position of the token. */
+    public function getEndPos(): int {
+        return $this->pos + \strlen($this->text);
+    }
+
+    /** Get 1-based end line number of the token. */
+    public function getEndLine(): int {
+        return $this->line + \substr_count($this->text, "\n");
+    }
+}

package/php-subsystem/vendor/nikic/php-parser/lib/PhpParser/compatibility_tokens.php

@@ -0,0 +1,63 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser;
+
+if (!\function_exists('PhpParser\defineCompatibilityTokens')) {
+    function defineCompatibilityTokens(): void {
+        $compatTokens = [
+            // PHP 8.0
+            'T_NAME_QUALIFIED',
+            'T_NAME_FULLY_QUALIFIED',
+            'T_NAME_RELATIVE',
+            'T_MATCH',
+            'T_NULLSAFE_OBJECT_OPERATOR',
+            'T_ATTRIBUTE',
+            // PHP 8.1
+            'T_ENUM',
+            'T_AMPERSAND_NOT_FOLLOWED_BY_VAR_OR_VARARG',
+            'T_AMPERSAND_FOLLOWED_BY_VAR_OR_VARARG',
+            'T_READONLY',
+        ];
+
+        // PHP-Parser might be used together with another library that also emulates some or all
+        // of these tokens. Perform a sanity-check that all already defined tokens have been
+        // assigned a unique ID.
+        $usedTokenIds = [];
+        foreach ($compatTokens as $token) {
+            if (\defined($token)) {
+                $tokenId = \constant($token);
+                if (!\is_int($tokenId)) {
+                    throw new \Error(sprintf(
+                        'Token %s has ID of type %s, should be int. ' .
+                        'You may be using a library with broken token emulation',
+                        $token, \gettype($tokenId)
+                    ));
+                }
+                $clashingToken = $usedTokenIds[$tokenId] ?? null;
+                if ($clashingToken !== null) {
+                    throw new \Error(sprintf(
+                        'Token %s has same ID as token %s, ' .
+                        'you may be using a library with broken token emulation',
+                        $token, $clashingToken
+                    ));
+                }
+                $usedTokenIds[$tokenId] = $token;
+            }
+        }
+
+        // Now define any tokens that have not yet been emulated. Try to assign IDs from -1
+        // downwards, but skip any IDs that may already be in use.
+        $newTokenId = -1;
+        foreach ($compatTokens as $token) {
+            if (!\defined($token)) {
+                while (isset($usedTokenIds[$newTokenId])) {
+                    $newTokenId--;
+                }
+                \define($token, $newTokenId);
+                $newTokenId--;
+            }
+        }
+    }
+
+    defineCompatibilityTokens();
+}

package/boilerplate/stubs/backend/api-controller/create.php

@@ -1,53 +0,0 @@
-<?php
-
-namespace <%= classNamespace %>;
-
-use Flarum\Api\Controller\AbstractCreateController;
-use Flarum\Http\RequestUtil;<% if (typeof handlerCommandClass !== 'undefined' && handlerCommandClass) { %>
-use Illuminate\Contracts\Bus\Dispatcher;<% } %>
-use Illuminate\Support\Arr;
-use Psr\Http\Message\ServerRequestInterface;
-use Tobscure\JsonApi\Document;<% if (typeof handlerCommandClass !== 'undefined' && handlerCommandClass) { %>
-use <%= handlerCommandClass %>;<% } %>
-use <%= serializerClass %>;
-
-class <%= className %> extends AbstractCreateController
-{
-    /**
-     * {@inheritdoc}
-     */
-    public $serializer = <%= serializerClassName %>::class;
-<% if (typeof handlerCommandClassName !== 'undefined' && handlerCommandClassName) { %>
-    /**
-     * @var Dispatcher
-     */
-    protected $bus;
-
-    /**
-     * @param Dispatcher $bus
-     */
-    public function __construct(Dispatcher $bus)
-    {
-        $this->bus = $bus;
-    }
-
-<% } %>
-    /**
-     * {@inheritdoc}
-     */
-    protected function data(ServerRequestInterface $request, Document $document)
-    {
-        // See https://docs.flarum.org/extend/api.html#api-endpoints for more information.
-
-        $actor = RequestUtil::getActor($request);
-        $data = Arr::get($request->getParsedBody(), 'data', []);
-        <% if (typeof handlerCommandClassName !== 'undefined' && handlerCommandClassName) { %>
-        $model = $this->bus->dispatch(
-            new <%= handlerCommandClassName %>($actor, $data)
-        );
-        <% } else { %>
-        // $model = ...
-        <% } %>
-        return $model;
-    }
-}

package/boilerplate/stubs/backend/api-controller/delete.php

@@ -1,52 +0,0 @@
-<?php
-
-namespace <%= classNamespace %>;
-
-use Flarum\Api\Controller\AbstractDeleteController;
-use Flarum\Http\RequestUtil;<% if (typeof handlerCommandClass !== 'undefined' && handlerCommandClass) { %>
-use Illuminate\Contracts\Bus\Dispatcher;<% } %>
-use Illuminate\Support\Arr;
-use Psr\Http\Message\ServerRequestInterface;<% if (typeof handlerCommandClass !== 'undefined' && handlerCommandClass) { %>
-use <%= handlerCommandClass %>;<% } %>
-use <%= serializerClass %>;
-
-class <%= className %> extends AbstractDeleteController
-{
-    /**
-     * {@inheritdoc}
-     */
-    public $serializer = <%= serializerClassName %>::class;
-<% if (typeof handlerCommandClassName !== 'undefined' && handlerCommandClassName) { %>
-    /**
-     * @var Dispatcher
-     */
-    protected $bus;
-
-    /**
-     * @param Dispatcher $bus
-     */
-    public function __construct(Dispatcher $bus)
-    {
-        $this->bus = $bus;
-    }
-
-<% } %>
-    /**
-     * {@inheritdoc}
-     */
-    protected function delete(ServerRequestInterface $request)
-    {
-        // See https://docs.flarum.org/extend/api.html#api-endpoints for more information.
-
-        $modelId = Arr::get($request->getQueryParams(), 'id');
-        $actor = RequestUtil::getActor($request);
-        $input = $request->getParsedBody();
-        <% if (typeof handlerCommandClassName !== 'undefined' && handlerCommandClassName) { %>
-        $this->bus->dispatch(
-            new <%= handlerCommandClassName %>($modelId, $actor, $input)
-        );
-        <% } else { %>
-        // ...
-        <% } %>
-    }
-}

package/boilerplate/stubs/backend/api-controller/list.php

@@ -1,61 +0,0 @@
-<?php
-
-namespace <%= classNamespace %>;
-
-use Flarum\Api\Controller\AbstractListController;
-use Flarum\Http\RequestUtil;
-use Flarum\Http\UrlGenerator;
-use Psr\Http\Message\ServerRequestInterface;
-use Tobscure\JsonApi\Document;
-use <%= serializerClass %>;
-
-class <%= className %> extends AbstractListController
-{
-    /**
-     * {@inheritdoc}
-     */
-    public $serializer = <%= serializerClassName %>::class;
-
-    /**
-     * @var UrlGenerator
-     */
-    protected $url;
-
-    /**
-     * @param UrlGenerator $url
-     */
-    public function __construct(UrlGenerator $url)
-    {
-        $this->url = $url;
-    }
-
-    /**
-     * {@inheritdoc}
-     */
-    protected function data(ServerRequestInterface $request, Document $document)
-    {
-        // See https://docs.flarum.org/extend/api.html#api-endpoints for more information.
-
-        $actor = RequestUtil::getActor($request);
-
-        $filters = $this->extractFilter($request);
-        $sort = $this->extractSort($request);
-
-        $limit = $this->extractLimit($request);
-        $offset = $this->extractOffset($request);
-        $include = $this->extractInclude($request);
-
-        // ...
-        // $results = ...;
-
-        $document->addPaginationLinks(
-            $this->url->to('api')->route('...'),
-            $request->getQueryParams(),
-            $offset,
-            $limit,
-            $results->areMoreResults() ? null : 0
-        );
-
-        return $results;
-    }
-}

package/boilerplate/stubs/backend/api-controller/normal.php

@@ -1,29 +0,0 @@
-<?php
-
-namespace <%= classNamespace %>;
-
-use Flarum\Api\Controller\AbstractSerializeController;
-use Psr\Http\Message\ServerRequestInterface;
-use Tobscure\JsonApi\Collection;
-use Tobscure\JsonApi\Resource;
-use Tobscure\JsonApi\SerializerInterface;
-use <%= serializerClass %>;
-
-class <%= className %> extends AbstractSerializeController
-{
-    /**
-     * {@inheritdoc}
-     */
-    public $serializer = <%= serializerClassName %>::class;
-
-    /**
-     * {@inheritdoc}
-     */
-    protected function createElement($data, SerializerInterface $serializer)
-    {
-        // See https://docs.flarum.org/extend/api.html#api-endpoints for more information.
-
-        // return new Collection($data, $serializer);
-        // return new Resource($data, $serializer);
-    }
-}

package/boilerplate/stubs/backend/api-controller/show.php

@@ -1,48 +0,0 @@
-<?php
-
-namespace <%= classNamespace %>;
-
-use Flarum\Api\Controller\AbstractShowController;
-use Flarum\Http\RequestUtil;
-use Illuminate\Support\Arr;
-use Psr\Http\Message\ServerRequestInterface;
-use Tobscure\JsonApi\Document;<% if (typeof repositoryClass !== 'undefined' && repositoryClass) { %>
-use <%= repositoryClass %>;<% } %>
-use <%= serializerClass %>;
-
-class <%= className %> extends AbstractShowController
-{
-    /**
-     * {@inheritdoc}
-     */
-    public $serializer = <%= serializerClassName %>::class;
-<% if (typeof repositoryClassName !== 'undefined' && repositoryClassName) { %>
-    /**
-     * @var <%= repositoryClassName %>
-     */
-    protected $repository;
-
-    /**
-     * @param <%= repositoryClassName %> $repository
-     */
-    public function __construct(<%= repositoryClassName %> $repository)
-    {
-        $this->repository = $repository;
-    }
-
-<% } %>
-    /**
-     * {@inheritdoc}
-     */
-    protected function data(ServerRequestInterface $request, Document $document)
-    {
-        // See https://docs.flarum.org/extend/api.html#api-endpoints for more information.
-
-        $actor = RequestUtil::getActor($request);
-        $modelId = Arr::get($request->getQueryParams(), 'id');
-
-        // $model = ...;
-
-        return $model;
-    }
-}

package/boilerplate/stubs/backend/api-controller/update.php

@@ -1,54 +0,0 @@
-<?php
-
-namespace <%= classNamespace %>;
-
-use Flarum\Api\Controller\AbstractShowController;
-use Flarum\Http\RequestUtil;<% if (typeof handlerCommandClass !== 'undefined' && handlerCommandClass) { %>
-use Illuminate\Contracts\Bus\Dispatcher;<% } %>
-use Illuminate\Support\Arr;
-use Psr\Http\Message\ServerRequestInterface;
-use Tobscure\JsonApi\Document;<% if (typeof handlerCommandClass !== 'undefined' && handlerCommandClass) { %>
-use <%= handlerCommandClass %>;<% } %>
-use <%= serializerClass %>;
-
-class <%= className %> extends AbstractShowController
-{
-    /**
-     * {@inheritdoc}
-     */
-    public $serializer = <%= serializerClassName %>::class;
-<% if (typeof handlerCommandClassName !== 'undefined' && handlerCommandClassName) { %>
-    /**
-     * @var Dispatcher
-     */
-    protected $bus;
-
-    /**
-     * @param Dispatcher $bus
-     */
-    public function __construct(Dispatcher $bus)
-    {
-        $this->bus = $bus;
-    }
-
-<% } %>
-    /**
-     * {@inheritdoc}
-     */
-    protected function data(ServerRequestInterface $request, Document $document)
-    {
-        // See https://docs.flarum.org/extend/api.html#api-endpoints for more information.
-
-        $actor = RequestUtil::getActor($request);
-        $modelId = Arr::get($request->getQueryParams(), 'id');
-        $data = Arr::get($request->getParsedBody(), 'data', []);
-        <% if (typeof handlerCommandClassName !== 'undefined' && handlerCommandClassName) { %>
-        $model = $this->bus->dispatch(
-            new <%= handlerCommandClassName %>($modelId, $actor, $data)
-        );
-        <% } else { %>
-        // $model = ...
-        <% } %>
-        return $model;
-    }
-}

package/boilerplate/stubs/backend/api-serializer.php

@@ -1,36 +0,0 @@
-<?php
-
-namespace <%= classNamespace %>;
-
-use Flarum\Api\Serializer\AbstractSerializer;
-use <%= modelClass %>;
-use InvalidArgumentException;
-
-class <%= className %> extends AbstractSerializer
-{
-    /**
-     * {@inheritdoc}
-     */
-    protected $type = '<%= modelType %>';
-
-    /**
-     * {@inheritdoc}
-     *
-     * @param <%= modelClassName %> $model
-     * @throws InvalidArgumentException
-     */
-    protected function getDefaultAttributes($model)
-    {
-        if (! ($model instanceof <%= modelClassName %>)) {
-            throw new InvalidArgumentException(
-                get_class($this).' can only serialize instances of '.<%= modelClassName %>::class
-            );
-        }
-
-        // See https://docs.flarum.org/extend/api.html#serializers for more information.
-
-        return [
-            // ...
-        ];
-    }
-}

package/lib/commands/make/backend/api-controller.js

@@ -1,27 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-const base_command_1 = (0, tslib_1.__importDefault)(require("../../../base-command"));
-const api_controller_1 = require("../../../steps/stubs/backend/api-controller");
-const route_1 = require("../../../steps/extenders/route");
-const gen_ext_scaffolder_1 = require("../../../steps/gen-ext-scaffolder");
-class ApiController extends base_command_1.default {
-    steps(stepManager) {
-        return stepManager
-            .atomicGroup(stepManager => {
-            stepManager
-                .namedStep('apiController', new api_controller_1.GenerateApiControllerStub(this.STUB_PATH, (0, gen_ext_scaffolder_1.genExtScaffolder)()))
-                .step(new route_1.GenerateRoutesExtender(), { optional: true, confirmationMessage: 'Generate corresponding extender?', default: true }, [
-                {
-                    sourceStep: 'apiController',
-                    exposedName: 'class',
-                    consumedName: 'routeHandler',
-                },
-            ]);
-        });
-    }
-}
-exports.default = ApiController;
-ApiController.description = 'Generate an API controller class';
-ApiController.flags = Object.assign({}, base_command_1.default.flags);
-ApiController.args = [...base_command_1.default.args];

package/lib/commands/make/backend/api-serializer-attributes.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-const base_command_1 = (0, tslib_1.__importDefault)(require("../../../base-command"));
-const api_serializer_1 = require("../../../steps/extenders/api-serializer");
-class ApiSerializerAttribute extends base_command_1.default {
-    steps(stepManager) {
-        return stepManager
-            .step(new api_serializer_1.GenerateApiSerializerAttributesExtender());
-    }
-}
-exports.default = ApiSerializerAttribute;
-ApiSerializerAttribute.description = 'Generate an API serializer attributes extender';
-ApiSerializerAttribute.flags = Object.assign({}, base_command_1.default.flags);
-ApiSerializerAttribute.args = [...base_command_1.default.args];

package/lib/commands/make/backend/api-serializer.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-const gen_ext_scaffolder_1 = require("../../../steps/gen-ext-scaffolder");
-const base_command_1 = (0, tslib_1.__importDefault)(require("../../../base-command"));
-const api_serializer_1 = require("../../../steps/stubs/backend/api-serializer");
-class ApiSerializer extends base_command_1.default {
-    steps(stepManager) {
-        return stepManager.step(new api_serializer_1.GenerateApiSerializerStub(this.STUB_PATH, (0, gen_ext_scaffolder_1.genExtScaffolder)()));
-    }
-}
-exports.default = ApiSerializer;
-ApiSerializer.description = 'Generate an API serializer class';
-ApiSerializer.flags = Object.assign({}, base_command_1.default.flags);
-ApiSerializer.args = [...base_command_1.default.args];

package/lib/steps/extenders/api-serializer.js

@@ -1,77 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GenerateApiSerializerAttributesExtender = void 0;
-const tslib_1 = require("tslib");
-const chalk_1 = (0, tslib_1.__importDefault)(require("chalk"));
-const validation_1 = require("../../utils/validation");
-const php_provider_1 = require("../../providers/php-provider");
-const base_1 = require("./base");
-class GenerateApiSerializerAttributesExtender extends base_1.BaseExtenderStep {
-    constructor() {
-        super(...arguments);
-        this.type = 'Generate API Serializer attributes extender';
-        this.schema = {
-            extenderDef: {
-                extender: {
-                    className: '\\Flarum\\Extend\\ApiSerializer',
-                    args: [
-                        {
-                            type: php_provider_1.ExpressionType.CLASS_CONST,
-                            value: '${serializerClass}',
-                            auxiliaryValue: 'class',
-                        },
-                    ],
-                },
-                methodCalls: [
-                    {
-                        methodName: 'attributes',
-                        args: [
-                            {
-                                type: php_provider_1.ExpressionType.CLOSURE,
-                                value: {
-                                    params: [
-                                        {
-                                            name: 'serializer',
-                                            type: '${serializerClass}',
-                                            typeType: php_provider_1.ParamTypeType.CLASS,
-                                        },
-                                        {
-                                            name: 'model',
-                                            type: '${modelClass}',
-                                            typeType: php_provider_1.ParamTypeType.CLASS,
-                                        },
-                                        {
-                                            name: 'attributes',
-                                            type: 'array',
-                                            typeType: php_provider_1.ParamTypeType.PRIMITIVE,
-                                        },
-                                    ],
-                                    commentText: 'See https://docs.flarum.org/extend/api.html#serializers',
-                                    return: {
-                                        type: php_provider_1.ExpressionType.VARIABLE,
-                                        value: 'attributes',
-                                    },
-                                },
-                            },
-                        ],
-                    },
-                ],
-            },
-            params: [
-                {
-                    name: 'serializerClass',
-                    type: 'text',
-                    validate: validation_1.Validator.class,
-                    message: `API Serializer (${chalk_1.default.dim('Vendor\\Path\\Api\\Serializer\\Class')})`,
-                },
-                {
-                    name: 'modelClass',
-                    type: 'text',
-                    validate: validation_1.Validator.class,
-                    message: `Model (${chalk_1.default.dim('Vendor\\Path\\Model\\Class')})`,
-                },
-            ],
-        };
-    }
-}
-exports.GenerateApiSerializerAttributesExtender = GenerateApiSerializerAttributesExtender;

package/lib/steps/stubs/backend/api-controller.js

@@ -1,62 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GenerateApiControllerStub = void 0;
-const tslib_1 = require("tslib");
-const chalk_1 = (0, tslib_1.__importDefault)(require("chalk"));
-const validation_1 = require("../../../utils/validation");
-const php_base_1 = require("../php-base");
-class GenerateApiControllerStub extends php_base_1.BasePhpStubStep {
-    constructor() {
-        super(...arguments);
-        this.type = 'Generate Api Controller Class';
-        this.additionalExposes = [];
-        this.phpClassParams = ['serializerClass', 'handlerCommandClass'];
-        this.schema = {
-            recommendedSubdir: 'Api/Controller',
-            sourceFile: 'backend/api-controller/${classType}.php',
-            params: [
-                {
-                    name: 'className',
-                    type: 'text',
-                    message: 'Api Controller class name',
-                    validate: validation_1.Validator.className,
-                },
-                {
-                    name: 'classNamespace',
-                    type: 'text',
-                },
-                {
-                    name: 'classType',
-                    type: 'autocomplete',
-                    message: 'Api Controller type',
-                    choices: ['Normal', 'List', 'Show', 'Create', 'Update', 'Delete'].map((type) => ({
-                        title: type,
-                        value: type.toLowerCase(),
-                    })),
-                },
-                {
-                    name: 'serializerClass',
-                    type: 'text',
-                    message: `Serializer Class (${chalk_1.default.dim('Vendor\\Path\\Serializer')})`,
-                    validate: validation_1.Validator.class,
-                },
-                {
-                    name: 'serializerClassName',
-                    type: 'text',
-                },
-                {
-                    name: 'handlerCommandClass',
-                    type: 'text',
-                    message: `Handler Command Class (${chalk_1.default.dim('Vendor\\Path\\Command')}) (Optional)`,
-                    validate: validation_1.Validator.optionalClass,
-                    optional: true,
-                },
-                {
-                    name: 'handlerCommandClassName',
-                    type: 'text',
-                },
-            ],
-        };
-    }
-}
-exports.GenerateApiControllerStub = GenerateApiControllerStub;

package/lib/steps/stubs/frontend/migration.js

@@ -1 +0,0 @@
-"use strict";

package/php-subsystem/vendor/nikic/php-parser/.editorconfig

@@ -1,9 +0,0 @@
-root = true
-
-[*.y]
-charset = utf-8
-end_of_line = lf
-insert_final_newline = true
-trim_trailing_whitespace = true
-indent_style = space
-indent_size = 4

package/php-subsystem/vendor/nikic/php-parser/grammar/README.md

@@ -1,30 +0,0 @@
-What do all those files mean?
-=============================
-
- * `php5.y`:             PHP 5 grammar written in a pseudo language
- * `php7.y`:             PHP 7 grammar written in a pseudo language
- * `tokens.y`:           Tokens definition shared between PHP 5 and PHP 7 grammars
- * `parser.template`:    A `kmyacc` parser prototype file for PHP
- * `tokens.template`:    A `kmyacc` prototype file for the `Tokens` class
- * `rebuildParsers.php`: Preprocesses the grammar and builds the parser using `kmyacc`
-
-.phpy pseudo language
-=====================
-
-The `.y` file is a normal grammar in `kmyacc` (`yacc`) style, with some transformations
-applied to it:
-
- * Nodes are created using the syntax `Name[..., ...]`. This is transformed into
-   `new Name(..., ..., attributes())`
- * Some function-like constructs are resolved (see `rebuildParsers.php` for a list)
-
-Building the parser
-===================
-
-Run `php grammar/rebuildParsers.php` to rebuild the parsers. Additional options:
-
- * The `KMYACC` environment variable can be used to specify an alternative `kmyacc` binary.
-   By default the `phpyacc` dev dependency will be used. To use the original `kmyacc`, you
-   need to compile [moriyoshi's fork](https://github.com/moriyoshi/kmyacc-forked).
- * The `--debug` option enables emission of debug symbols and creates the `y.output` file.
- * The `--keep-tmp-grammar` option preserves the preprocessed grammar file.