sentry 0.1.2 → 0.3.0

package/LICENSE.md

@@ -0,0 +1,105 @@
+# Functional Source License, Version 1.1, Apache 2.0 Future License
+
+## Abbreviation
+
+FSL-1.1-Apache-2.0
+
+## Notice
+
+Copyright 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 Apache License, Version 2.0 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 Apache License, Version 2.0, in which case the following
+will apply:
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License.
+
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. See the License for the
+specific language governing permissions and limitations under the License.

package/README.md

@@ -1,82 +1,113 @@
-# Sentry
+# sentry
 
-Sentry is a simple node tool to watch for file changes (using a path, wildcards, or regexes) and execute a function or shell command. It's like a [watchr](https://github.com/mynyml/watchr) or [guard](https://github.com/guard/guard) for node.
+A gh-like CLI for Sentry.
 
 ## Installation
 
-    $ npm install sentry
+Install globally with your preferred package manager:
 
-## Example
+```bash
+# npm
+npm install -g sentry
 
-````coffeescript
-sentry = require 'sentry'
+# pnpm
+pnpm add -g sentry
 
-# Watch changes in file.js
-sentry.watch 'file.js', (file) -> console.log "A change has been made in #{file}"
+# yarn
+yarn global add sentry
 
-# Watch changes on any file ending in .coffee one directory deep
-sentry.watch 'fld/*.coffee', ->
+# bun
+bun add -g sentry
+```
 
-# Watch changes recursively on any files 
-sentry.watch 'fld/**/*', ->
+Or run directly without installing:
 
-# Watch files recursively that match a regex
-sentry.watchRegExp 'fld/', /regex/, ->
+```bash
+npx sentry --help
+pnpm dlx sentry --help
+yarn dlx sentry --help
+bunx sentry --help
+```
 
-# If you pass a string instead of a function it'll execute that child process
-sentry.watch 'file.coffee', 'coffee -c'
-````
+## Setup
 
-## API
+```bash
+# Login via OAuth (device flow)
+sentry auth login
+```
 
-Sentry comes with two methods `watch` and `watchRegExp`.
+You'll be given a URL and a code to enter. Once you authorize, the CLI will automatically receive your token.
 
-### sentry.watch(filePath, [task], callback)
+Or use an API token directly:
 
-Optionally you may pass a task which will send `(err, stdout, stderr)` as the arguments to the callback
+```bash
+sentry auth login --token YOUR_SENTRY_API_TOKEN
+```
 
-````coffeescript
-sentry.watch 'file.js', 'coffee -c', (err, stdout, stderr) ->
-````
+## Commands
 
-Or simply just a callback and Sentry will pass the filename to the callback
+### Auth
 
-````coffeescript
-sentry.watch 'file.js', (filename) ->
-````
+```bash
+sentry auth login      # Login via OAuth device flow
+sentry auth logout     # Logout
+sentry auth status     # Check auth status
+```
 
-Feel free to use wildcards with extensions
+### Organizations
 
-````coffeescript
+```bash
+sentry org list                 # List all orgs
+sentry org list --json          # Output as JSON
+sentry org view my-org          # View organization details
+sentry org view my-org -w       # Open organization in browser
+```
 
-# Find all files one directory deep
-sentry.watch '/folder/*', ->
+### Projects
 
-# Find all files one directory deep ending in .coffee
-sentry.watch '/folder/*.coffee', ->
+```bash
+sentry project list                        # List all projects
+sentry project list my-org                 # List projects in org
+sentry project list --platform javascript  # Filter by platform
+sentry project view my-project             # View project details
+sentry project view my-project -w          # Open project in browser
+```
 
-# Find all files recursively
-sentry.watch '/folder/**/*', ->
+### Issues
 
-# Find all files recursively ending in .txt
-sentry.watch '/folder/**/*.txt', ->
-````
+```bash
+sentry issue list --org my-org --project my-project     # List issues
+sentry issue list --org my-org --project my-project --json
+sentry issue view 123456789                             # View issue by ID
+sentry issue view PROJ-ABC                              # View issue by short ID
+sentry issue view 123456789 -w                          # Open issue in browser
+```
 
-### sentry.watchRegExp(root, regex, [task], callback)
+### Events
 
-Just like sentry.watch but instead you must pass a root directory and regular expression to match files against.
+```bash
+sentry event view abc123def                              # View event by ID
+sentry event view abc123def -w                           # Open event in browser
+```
 
-````coffeescript
+### API
 
-# Find all files in this folder that end in .coffee
-sentry.watchRegExp '', /\.coffee$/, ->
+```bash
+sentry api /organizations/                              # GET request
+sentry api /issues/123/ --method PUT --field status=resolved
+sentry api /organizations/ --include                    # Show headers
+```
 
-# Find all files in the adjacent 'test' folder that begin with test and end in .coffee
-sentry.watchRegExp '../tests/', /^test_,.coffee$/, ->
-````
+## Development
 
-## To run tests
+```bash
+bun install
+bun run --env-file=.env.local src/bin.ts --help    # Run CLI in dev mode
+bun run build                                       # Build binary
+```
 
-Sentry uses [Jasmine-node](https://github.com/mhevery/jasmine-node) for testing. Simply run the jasmine-node command with the coffeescript flag
+See [DEVELOPMENT.md](DEVELOPMENT.md) for detailed development instructions.
 
-    jasmine-node spec --coffee
+## Config
+
+Stored in `~/.sentry/config.json` (mode 600).