@getmaito/cli 0.1.0

package/README.md

@@ -0,0 +1,70 @@
+# Maito CLI
+
+Command-line client for Maito.
+
+## Usage
+
+Install the CLI:
+
+```sh
+npm install -g @getmaito/cli
+```
+
+Then sign in:
+
+```sh
+maito login
+```
+
+Run commands:
+
+```sh
+maito posts list
+```
+
+## Auth
+
+Sign in for full CLI access:
+
+```sh
+maito login
+maito auth status
+maito logout
+```
+
+API keys are supported for customer API automation:
+
+```sh
+maito auth use-api-key --api-key <key>
+MAITO_API_KEY=<key> maito newsletter subscribers list --json
+maito posts list --api-key <key>
+```
+
+Auth precedence is:
+
+1. `--api-key`
+2. `MAITO_API_KEY`
+3. Saved sign-in session
+4. Stored API key
+
+API keys are intentionally limited to supported customer API endpoints. Run `maito login` for full user CLI access.
+
+## Updating
+
+Update the global install:
+
+```sh
+npm update -g @getmaito/cli
+```
+
+## Release
+
+The CLI package is published as `@getmaito/cli`.
+
+1. Bump `packages/cli/package.json` with semver.
+2. Run `bun run typecheck` from `packages/cli`.
+3. Run `bun run build` from `packages/cli`.
+4. Run `npm pack --dry-run` from `packages/cli` and verify the tarball only includes `dist`, `package.json`, and this README.
+5. Run `npm publish --access public` from `packages/cli`.
+
+Use patch versions for fixes, minor versions for new commands or backwards-compatible flags, and major versions for command or flag breaking changes.

package/dist/auth.d.ts

@@ -0,0 +1,42 @@
+export type StoredAuthSession = {
+    accessToken: string;
+    refreshToken: string;
+    clientId: string;
+    tokenEndpoint: string;
+    authorizationServer: string;
+    userinfoEndpoint?: string;
+    scope?: string;
+    tokenType?: string;
+    expiresAt: string;
+};
+export type StoredApiKey = {
+    apiKey: string;
+    createdAt: string;
+};
+export type AuthStatus = {
+    baseUrl: string;
+    session: StoredAuthSession;
+    user?: {
+        id?: string;
+        email?: string;
+        name?: string;
+        username?: string;
+    };
+};
+export declare function resolveApiBaseUrl(value?: string): string;
+export declare function login(input: {
+    baseUrl: string;
+    clientId?: string;
+}): Promise<AuthStatus>;
+export declare function logout(baseUrl: string): Promise<boolean>;
+export declare function saveApiKey(baseUrl: string, apiKey: string): Promise<void>;
+export declare function removeApiKey(baseUrl: string): Promise<boolean>;
+export declare function getStoredApiKey(baseUrl: string): Promise<string | null>;
+export declare function getAuthStatus(baseUrl: string): Promise<AuthStatus | null>;
+export declare function getAccessToken(baseUrl: string): Promise<string>;
+export declare function getCommandAuthToken(input: {
+    baseUrl: string;
+    apiKey?: string;
+}): Promise<string>;
+export declare function resetAuthStore(): Promise<void>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAwEA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,IAAI,CAAC,EAAE;QACL,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH,CAAC;AAoBF,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,UAK/C;AAED,wBAAsB,KAAK,CAAC,KAAK,EAAE;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,UAAU,CAAC,CAyHtB;AAED,wBAAsB,MAAM,CAAC,OAAO,EAAE,MAAM,oBAU3C;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,iBAc/D;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,oBAUjD;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAI7E;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAe5B;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWrE;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlB;AAqbD,wBAAsB,cAAc,kBAEnC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}