@sentry/cli 2.58.2 → 2.58.3-alpha0

package/LICENSE

@@ -1,27 +1,110 @@
-Copyright (c) 2016-2025 Sentry (https://sentry.io/) and individual contributors.
-All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are met:
-
-    1. Redistributions of source code must retain the above copyright notice,
-this list of conditions and the following disclaimer.
-
-    2. Redistributions in binary form must reproduce the above copyright
-notice, this list of conditions and the following disclaimer in the
-documentation and/or other materials provided with the distribution.
-
-    3. Neither the name of the Sentry nor the names of its contributors may be
-used to endorse or promote products derived from this software without specific
-prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
-ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
-WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
-FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
-SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
-CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+# Functional Source License, Version 1.1, MIT Future License
+
+## Abbreviation
+
+FSL-1.1-MIT
+
+## Notice
+
+Copyright 2008-2025 Functional Software, Inc. dba Sentry
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the MIT license that is effective on the second anniversary of the date we make
+the Software available. On or after that date, you may use the Software under
+the MIT license, in which case the following will apply:
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/checksums.txt

@@ -1,10 +1,7 @@
-sentry-cli-Darwin-arm64=f84d5716d74ea4b1355c64ef6cb6a14f2097ab2541c9747b7aee4bad39a647e4
-sentry-cli-Darwin-universal=5c893f7bc57dbcb87ec941c08420ef07cf485e931238c83cc8fbbe2ba69fec9f
-sentry-cli-Darwin-x86_64=e95fa80e6f06797c56eb4f18f65f82a4c859599c572d940e7a156885cbd8dd21
-sentry-cli-Linux-aarch64=3853e2071623941d96c7b69a99929f1d3222a4b696f4b74c875be340aa75926a
-sentry-cli-Linux-armv7=31fab9396e879ae49cd27aca025caa453ffbd965c2d018bd873f09d8d71a06d9
-sentry-cli-Linux-i686=a995decaad61160bfac84634b280f005003931726e14fd964f8c3cf6ce00aa20
-sentry-cli-Linux-x86_64=61b1c19345694ce31ac663e9875194d45f4f317f2b9134269605f810132df88b
-sentry-cli-Windows-aarch64.exe=a4a4dff5e176392510674b1afd73324bedf0ea66bdd8234654389429cda9b576
-sentry-cli-Windows-i686.exe=29290444fd2b796fe14c5d058eafe883293257f9f650fe20080bd37214b2ffe5
-sentry-cli-Windows-x86_64.exe=e89a23566d5e17a5fb2fe40e182e6e0a6cf07134330c7588d5b6025071bcae3f
+sentry-cli-Linux-aarch64=dc847900b90b04eb9ae12a342bb68626d6a617f0dd3e806038f8db34a02e438c
+sentry-cli-Linux-armv7=6293a4e62f0cf12d2882864f71f9d243675b7092cce32eabdbbb404c80dd7809
+sentry-cli-Linux-i686=306384389c5685cf7174e903a1bacf804080437b89bb9335656b06eeed313e3a
+sentry-cli-Linux-x86_64=d49103860d24e6ba630bc78bdc9da6afab34464c645a7418ff378d23d55628b6
+sentry-cli-Windows-aarch64.exe=c054d584647fc5e4c6cb401be2c2b4ab63a3efd5cef4663a37b077857191496e
+sentry-cli-Windows-i686.exe=43e44eb88462d0bc8c3eb9f1bceb1e94ada25b6d4dddc06b66dcb81860a78af7
+sentry-cli-Windows-x86_64.exe=3e468f56865bfa4dea45b5a113f7399f2514fc954e358aa12ca88da97407e511

package/js/helper.d.ts

@@ -0,0 +1,123 @@
+/**
+ * The javascript type of a command line option.
+ */
+export type OptionType = "array" | "string" | "boolean" | "inverted-boolean";
+/**
+ * Schema definition of a command line option.
+ */
+export type OptionSchema = {
+    /**
+     * The flag of the command line option including dashes.
+     */
+    param: string;
+    /**
+     * The value type of the command line option.
+     */
+    type: OptionType;
+    /**
+     * The flag of the command line option including dashes (optional).
+     */
+    invertedParam?: string;
+};
+/**
+ * Schema definition for a command.
+ */
+export type OptionsSchema = {
+    [x: string]: OptionSchema;
+};
+/**
+ * Runs `sentry-cli` with the given command line arguments.
+ *
+ * Use {@link prepareCommand} to specify the command and add arguments for command-
+ * specific options. For top-level options, use {@link serializeOptions} directly.
+ *
+ * The returned promise resolves with the standard output of the command invocation
+ * including all newlines. In order to parse this output, be sure to trim the output
+ * first.
+ *
+ * If the command failed to execute, the Promise rejects with the error returned by the
+ * CLI. This error includes a `code` property with the process exit status.
+ *
+ * @example
+ * const output = await execute(['--version']);
+ * expect(output.trim()).toBe('sentry-cli x.y.z');
+ *
+ * @param {string[]} args Command line arguments passed to `sentry-cli`.
+ * @param {boolean | 'rejectOnError'} live can be set to:
+ *  - `true` to inherit stdio to display `sentry-cli` output directly.
+ *  - `false` to not inherit stdio and return the output as a string.
+ *  - `'rejectOnError'` to inherit stdio and reject the promise if the command
+ *    exits with a non-zero exit code.
+ * @param {boolean} silent Disable stdout for silents build (CI/Webpack Stats, ...)
+ * @param {string} [configFile] Relative or absolute path to the configuration file.
+ * @param {import('./index').SentryCliOptions} [config] More configuration to pass to the CLI
+ * @returns {Promise<string>} A promise that resolves to the standard output.
+ */
+export function execute(args: string[], live: boolean | "rejectOnError", silent: boolean, configFile?: string, config?: import("./index").SentryCliOptions): Promise<string>;
+/**
+ * Returns the absolute path to the `sentry-cli` binary.
+ * @returns {string}
+ */
+export function getPath(): string;
+export function getProjectFlagsFromOptions({ projects }?: {
+    projects?: any[];
+}): any;
+/**
+ * Overrides the default binary path with a mock value, useful for testing.
+ *
+ * @param {string} mockPath The new path to the mock sentry-cli binary
+ * @deprecated This was used in tests internally and will be removed in the next major version.
+ */
+export function mockBinaryPath(mockPath: string): void;
+/**
+ * Serializes the command and its options into an arguments array.
+ *
+ * @param {string[]} command The literal name of the command.
+ * @param {OptionsSchema} [schema] An options schema required by the command.
+ * @param {object} [options] An options object according to the schema.
+ * @returns {string[]} An arguments array that can be passed via command line.
+ */
+export function prepareCommand(command: string[], schema?: OptionsSchema, options?: object): string[];
+/**
+ * The javascript type of a command line option.
+ * @typedef {'array'|'string'|'boolean'|'inverted-boolean'} OptionType
+ */
+/**
+ * Schema definition of a command line option.
+ * @typedef {object} OptionSchema
+ * @prop {string} param The flag of the command line option including dashes.
+ * @prop {OptionType} type The value type of the command line option.
+ * @prop {string} [invertedParam] The flag of the command line option including dashes (optional).
+ */
+/**
+ * Schema definition for a command.
+ * @typedef {Object.<string, OptionSchema>} OptionsSchema
+ */
+/**
+ * Serializes command line options into an arguments array.
+ *
+ * @param {OptionsSchema} schema An options schema required by the command.
+ * @param {object} options An options object according to the schema.
+ * @returns {string[]} An arguments array that can be passed via command line.
+ */
+export function serializeOptions(schema: OptionsSchema, options: object): string[];
+export function getDistributionForThisPlatform(): {
+    packageName: string;
+    subpath: string;
+};
+/**
+ * Throws an error with a message stating that Sentry CLI doesn't support the current platform.
+ *
+ * @returns {never} nothing. It throws.
+ */
+export function throwUnsupportedPlatformError(): never;
+/**
+ * This convoluted function resolves the path to the manually downloaded fallback
+ * `sentry-cli` binary in a way that can't be analysed by @vercel/nft.
+ *
+ * Without this, the binary can be detected as an asset and included by bundlers
+ * that use @vercel/nft.
+ *
+ * @returns {string} The path to the sentry-cli binary
+ */
+export function getFallbackBinaryPath(): string;