Initial cli-installer implementation

.github/workflows/pr-check-signed-commits.yml

@@ -0,0 +1,13 @@
+on: pull_request_target
+name: Check signed commits in PR
+
+jobs:
+  build:
+    name: Check signed commits in PR
+    permissions:
+      contents: read
+      pull-requests: write
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check signed commits in PR
+        uses: 1Password/check-signed-commits-action@v1

.github/workflows/test.yml

@@ -0,0 +1,19 @@
+on: push
+name: Run tests
+
+jobs:
+  jest-tests:
+    name: "Type check, lint, format, and test"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install dependencies
+        run: npm install
+      - name: Type check
+        run: npm run typecheck
+      - name: Lint code
+        run: npm run lint
+      - name: Check formatting
+        run: npm run format:check
+      - name: Run Jest tests
+        run: npm run test

.gitignore

@@ -0,0 +1,3 @@
+node_modules/
+coverage/
+dist/

.husky/pre-commit

@@ -0,0 +1 @@
+npx lint-staged --config ./lint-staged.config.mjs

.prettierignore

@@ -0,0 +1,3 @@
+coverage/
+dist/
+node_modules/

CONTRIBUTING.md

@@ -0,0 +1,37 @@
+# Contributing
+
+Thank you for your interest in contributing to the 1Password `op-cli-installer` project 👋! Before you start, please take a moment to read through this guide to understand our contribution process.
+
+## Testing
+
+Unit tests can be run with `npm run test`.
+
+## Documentation Updates
+
+If applicable, update the [README.md](./README.md) to reflect any changes introduced by the new code.
+
+## Sign your commits
+
+To get your PR merged, we require you to sign your commits.
+
+### Sign commits with 1Password
+
+You can also sign commits using 1Password, which lets you sign commits with biometrics without the signing key leaving the local 1Password process.
+
+Learn how to use [1Password to sign your commits](https://developer.1password.com/docs/ssh/git-commit-signing/).
+
+### Sign commits with ssh-agent
+
+Follow the steps below to set up commit signing with `ssh-agent`:
+
+1. [Generate an SSH key and add it to ssh-agent](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)
+2. [Add the SSH key to your GitHub account](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account)
+3. [Configure git to use your SSH key for commits signing](https://docs.github.com/en/authentication/managing-commit-signature-verification/telling-git-about-your-signing-key#telling-git-about-your-ssh-key)
+
+### Sign commits with gpg
+
+Follow the steps below to set up commit signing with `gpg`:
+
+1. [Generate a GPG key](https://docs.github.com/en/authentication/managing-commit-signature-verification/generating-a-new-gpg-key)
+2. [Add the GPG key to your GitHub account](https://docs.github.com/en/authentication/managing-commit-signature-verification/adding-a-gpg-key-to-your-github-account)
+3. [Configure git to use your GPG key for commits signing](https://docs.github.com/en/authentication/managing-commit-signature-verification/telling-git-about-your-signing-key#telling-git-about-your-gpg-key)

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 1Password
+
+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.

README.md

@@ -1,2 +1,10 @@
-# op-cli-installer
-Install the 1Password CLI to access and manage 1Password items in your Node.js applications
+<!-- Image sourced from https://blog.1password.com/1password-cli-2_0/ -->
+<img alt="" role="img" src="https://blog.1password.com/posts/2022/1password-cli-2.0/header.png"/>
+
+<div align="center">
+	<h1>1Password CLI installer for Node.js</h1>
+	<p>Install the <a href="https://developer.1password.com/docs/cli">1Password CLI</a> to access and manage your 1Password items in your Node.js applications.</p>
+	<a href="#✨-quickstart">
+		<img alt="Get started" src="https://user-images.githubusercontent.com/45081667/226940040-16d3684b-60f4-4d95-adb2-5757a8f1bc15.png" height="37"/>
+	</a>
+</div>

eslint.config.mjs

@@ -0,0 +1,12 @@
+import opLintConfig from "@1password/eslint-config";
+import tseslint from "typescript-eslint";
+
+export default tseslint.config({
+	extends: [opLintConfig],
+	ignores: ["dist"],
+	languageOptions: {
+		parserOptions: {
+			project: true,
+		},
+	},
+});

jest.config.mjs

@@ -0,0 +1,17 @@
+const jestConfig = {
+	moduleFileExtensions: ["ts", "js", "json"],
+	rootDir: ".",
+	testEnvironment: "node",
+	testRegex: "(/__tests__/.*|(\\.|/)test)\\.ts",
+	transform: {
+		".ts": [
+			"ts-jest",
+			{
+				useESM: true,
+			},
+		],
+	},
+	verbose: true,
+};
+
+export default jestConfig;

lint-staged.config.mjs

@@ -0,0 +1,6 @@
+const lintStagedConfig = {
+	"*.{js,json,md,ts,yaml,yml}": "npm run format:write",
+	"src/**/*.ts": ["npm run lint:fix"],
+};
+
+export default lintStagedConfig;