@iflowgate/cli 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   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,3 +1,156 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# Flowgate SDK
+
+Typed clients for the Flowgate governed execution layer — a TypeScript SDK, a
+command-line interface, and an MCP server for programmatic, shell, and
+LLM-driven access to the Flowgate API.
+
+This is a pnpm monorepo containing three packages:
+
+| Package | Description |
+| --- | --- |
+| [`@iflowgate/sdk`](packages/sdk) | Type-safe client generated from the OpenAPI spec |
+| [`@iflowgate/cli`](packages/cli) | The `flowgate` command-line interface |
+| [`@iflowgate/mcp-server`](packages/mcp-server) | Model Context Protocol server (stdio) |
+
+## API access
+
+Flowgate API access is provisioned per integrator. The demo deployment shown in
+this README requires an API key that is not publicly distributed. To request
+access for evaluation, contact reda.halloub@gmail.com.
+
+## Installation
+
+```bash
+npm install @iflowgate/sdk @iflowgate/cli
+```
+
+> **Note:** these packages are not yet published to npm. They are currently
+> available via the workspace / private registry. Publishing is a separate
+> milestone. Until then, clone this repository and link the packages locally.
+
+## SDK quickstart
+
+```ts
+import { Flowgate } from '@iflowgate/sdk';
+
+const fg = new Flowgate({ apiKey: process.env.FLOWGATE_API_KEY });
+
+const issuers = await fg.issuers.list();
+const capTable = await fg.capTable.get('Flowgate Systems Inc.');
+console.log(capTable.total_fully_diluted_shares);
+```
+
+Every request and response type is generated from the committed OpenAPI spec
+(`openapi.json`), so parameters, bodies, and results are checked at compile
+time.
+
+### Error handling
+
+Non-2xx responses throw a `FlowgateError` carrying the HTTP `status`, the
+parsed `detail` from the API, and the `endpoint` that was called.
+
+```ts
+import { Flowgate, FlowgateError } from '@iflowgate/sdk';
+
+try {
+  await fg.capTable.get('Unknown Issuer');
+} catch (error) {
+  if (error instanceof FlowgateError) {
+    console.error(error.status, error.detail, error.endpoint);
+  }
+}
+```
+
+## CLI quickstart
+
+The CLI reads your API key from the `FLOWGATE_API_KEY` environment variable.
+Substitute your own key for `<your-api-key>`:
+
+```bash
+export FLOWGATE_API_KEY=<your-api-key>
+
+flowgate issuers
+flowgate cap-table get "Flowgate Systems Inc."
+flowgate compliance rules
+```
+
+Add `--json` to any command for compact single-line JSON on stdout with the
+progress spinner disabled — useful for piping into `jq` or other scripts:
+
+```bash
+flowgate issuers --json
+```
+
+## SDK surface
+
+| Group | Methods |
+| --- | --- |
+| `capTable` | `get`, `proposals`, `approveProposal`, `rejectProposal` |
+| `capTableEvents` | `create` |
+| `investors` | `list`, `portfolio` |
+| `capitalCalls` | `list`, `overdue`, `payments` |
+| `compliance` | `rules`, `getRule`, `createRule` |
+| `issuers` | `list` |
+
+> **Note:** `approveProposal(id, { reviewer })` and `rejectProposal(id, { reviewer })`
+> accept a `reviewer` string and send it as the `?reviewer=` query parameter,
+> matching the API specification — these endpoints take no request body.
+
+## MCP server
+
+`@iflowgate/mcp-server` exposes Flowgate as read-only tools over stdio, so an
+LLM client can query the API directly.
+
+> **Note:** `@iflowgate/mcp-server` is not yet published to npm. Until it is,
+> run it from a local build (`node packages/mcp-server/dist/index.js`) instead
+> of via npx.
+
+Add it to your MCP client configuration:
+
+```json
+{
+  "mcpServers": {
+    "flowgate": {
+      "command": "npx",
+      "args": ["-y", "@iflowgate/mcp-server"],
+      "env": { "FLOWGATE_API_KEY": "<your-api-key>" }
+    }
+  }
+}
+```
+
+Available tools:
+
+| Tool | Description |
+| --- | --- |
+| `get_cap_table` | Get the cap table for an issuer |
+| `list_investors` | List all investors |
+| `get_investor_portfolio` | Get the portfolio for an investor |
+| `list_capital_calls` | List all capital calls |
+| `list_compliance_rules` | List all compliance rules |
+| `list_issuers` | List all issuers |
+
+The server requires `FLOWGATE_API_KEY` and exits with a stderr message if it is
+not set.
+
+## API reference
+
+Full API documentation is available at
+<https://flowgate2.onrender.com/redoc>.
+
+## Development
+
+Requires Node 20+ and pnpm.
+
+```bash
+pnpm install       # install workspace dependencies
+pnpm -r regen       # regenerate packages/sdk/src/schema.d.ts from openapi.json
+pnpm -r typecheck   # type-check every package
+pnpm -r test        # run the test suites
+pnpm -r build       # build every package
+```
+
+## License
+
+Apache License 2.0 — see [LICENSE](LICENSE).
+

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+/** Wires the CLI command tree. Exported for tests. */
+export declare function buildProgram(): Command;
+export interface RunCliOptions {
+    argv: string[];
+    stdout: (line: string) => void;
+    stderr: (line: string) => void;
+}
+/**
+ * Runs the CLI with the given argv and returns the process exit code.
+ * Used by the bin entry and by tests (no `process.exit` inside).
+ */
+export declare function runCli(opts: RunCliOptions): Promise<number>;
+//# 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":";AASA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBpC,sDAAsD;AACtD,wBAAgB,YAAY,IAAI,OAAO,CA6KtC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBjE"}

package/dist/index.js

@@ -0,0 +1,215 @@
+#!/usr/bin/env node
+/**
+ * flowgate — command-line interface for the Flowgate API.
+ *
+ * Every command reads FLOWGATE_API_KEY from the environment, shows an ora
+ * spinner while awaiting (unless `--json` is passed), and prints the result
+ * as JSON (2-space indent, or compact with `--json`).
+ */
+import { pathToFileURL } from 'node:url';
+import { Command } from 'commander';
+import { Flowgate } from '@iflowgate/sdk';
+import chalk from 'chalk';
+import { CliError, handleError, printResult, requireClient, withSpinner } from './output.js';
+/** Runs an async command body, converting thrown errors into exit codes. */
+async function runAction(json, action) {
+    try {
+        await action();
+    }
+    catch (error) {
+        const exitCode = handleError(error, json);
+        throw new CliError('', exitCode);
+    }
+}
+/** Builds the SDK client for a command invocation, or throws CliError. */
+function makeClient(json) {
+    return requireClient(json);
+}
+/** Wires the CLI command tree. Exported for tests. */
+export function buildProgram() {
+    const program = new Command();
+    program
+        .name('flowgate')
+        .description('Flowgate CLI — query issuers, cap tables, investors, capital calls, and compliance rules.')
+        .version('0.1.0');
+    const jsonOption = (cmd) => cmd.option('--json', 'output compact JSON (no spinner)');
+    jsonOption(program
+        .command('issuers')
+        .description('List issuers')
+        .action(async (options) => {
+        const json = options.json ?? false;
+        await runAction(json, async () => {
+            const { client } = makeClient(json);
+            const data = await withSpinner(json, 'Fetching issuers', () => client.issuers.list());
+            printResult(json, data);
+        });
+    }));
+    const capTable = program.command('cap-table').description('Cap table operations');
+    jsonOption(capTable.command('get').description('Get the cap table for an issuer').argument('<issuer>', 'issuer name')).action(async (issuer, options) => {
+        const json = options.json ?? false;
+        await runAction(json, async () => {
+            const { client } = makeClient(json);
+            const data = await withSpinner(json, `Fetching cap table for ${issuer}`, () => client.capTable.get(issuer));
+            printResult(json, data);
+        });
+    });
+    jsonOption(capTable
+        .command('history')
+        .description('Monthly or weekly snapshots of the cap table')
+        .argument('<issuer>', 'issuer name')
+        .option('-m, --months <n>', 'Number of months (1-24)', '6')
+        .option('-i, --interval <type>', 'monthly or weekly', 'monthly')).action(async (issuer, options) => {
+        const json = options.json ?? false;
+        await runAction(json, async () => {
+            const months = Number.parseInt(options.months, 10);
+            if (!Number.isFinite(months) || months < 1 || months > 24) {
+                throw new CliError(chalk.red('--months must be an integer between 1 and 24.'));
+            }
+            const interval = options.interval === 'weekly' ? 'weekly' : 'monthly';
+            const { client } = makeClient(json);
+            const data = await withSpinner(json, `Fetching cap table history for ${issuer}`, () => client.capTable.history(issuer, { months, interval }));
+            printResult(json, data);
+        });
+    });
+    jsonOption(capTable.command('proposals').description('List cap-table proposals').option('--status <status>', 'filter by proposal status')).action(async (options) => {
+        const json = options.json ?? false;
+        await runAction(json, async () => {
+            const { client } = makeClient(json);
+            const query = options.status !== undefined ? { status: options.status } : undefined;
+            const data = await withSpinner(json, 'Fetching cap-table proposals', () => client.capTable.proposals(query));
+            printResult(json, data);
+        });
+    });
+    jsonOption(capTable
+        .command('approve')
+        .description('Approve a cap-table proposal')
+        .argument('<id>', 'proposal id')
+        .requiredOption('--reviewer <reviewer>', 'reviewer identity (sent as ?reviewer=)')).action(async (id, options) => {
+        const json = options.json ?? false;
+        await runAction(json, async () => {
+            const { client } = makeClient(json);
+            const data = await withSpinner(json, `Approving proposal ${id}`, () => client.capTable.approveProposal(id, { reviewer: options.reviewer }));
+            printResult(json, data);
+        });
+    });
+    jsonOption(capTable
+        .command('reject')
+        .description('Reject a cap-table proposal')
+        .argument('<id>', 'proposal id')
+        .requiredOption('--reviewer <reviewer>', 'reviewer identity (sent as ?reviewer=)')).action(async (id, options) => {
+        const json = options.json ?? false;
+        await runAction(json, async () => {
+            const { client } = makeClient(json);
+            const data = await withSpinner(json, `Rejecting proposal ${id}`, () => client.capTable.rejectProposal(id, { reviewer: options.reviewer }));
+            printResult(json, data);
+        });
+    });
+    const investors = program.command('investors').description('Investor operations');
+    jsonOption(investors.command('list').description('List investors')).action(async (options) => {
+        const json = options.json ?? false;
+        await runAction(json, async () => {
+            const { client } = makeClient(json);
+            const data = await withSpinner(json, 'Fetching investors', () => client.investors.list());
+            printResult(json, data);
+        });
+    });
+    jsonOption(investors.command('portfolio').description('Get an investor portfolio').argument('<id>', 'investor id')).action(async (id, options) => {
+        const json = options.json ?? false;
+        await runAction(json, async () => {
+            const { client } = makeClient(json);
+            const data = await withSpinner(json, `Fetching portfolio for investor ${id}`, () => client.investors.portfolio(id));
+            printResult(json, data);
+        });
+    });
+    const capitalCalls = program.command('capital-calls').description('Capital call operations');
+    jsonOption(capitalCalls.command('list').description('List capital calls')).action(async (options) => {
+        const json = options.json ?? false;
+        await runAction(json, async () => {
+            const { client } = makeClient(json);
+            const data = await withSpinner(json, 'Fetching capital calls', () => client.capitalCalls.list());
+            printResult(json, data);
+        });
+    });
+    jsonOption(capitalCalls.command('overdue').description('List overdue capital calls')).action(async (options) => {
+        const json = options.json ?? false;
+        await runAction(json, async () => {
+            const { client } = makeClient(json);
+            const data = await withSpinner(json, 'Fetching overdue capital calls', () => client.capitalCalls.overdue());
+            printResult(json, data);
+        });
+    });
+    jsonOption(capitalCalls.command('payments').description('List payments for a capital call').argument('<id>', 'capital call id')).action(async (id, options) => {
+        const json = options.json ?? false;
+        await runAction(json, async () => {
+            const { client } = makeClient(json);
+            const data = await withSpinner(json, `Fetching payments for capital call ${id}`, () => client.capitalCalls.payments(id));
+            printResult(json, data);
+        });
+    });
+    const compliance = program.command('compliance').description('Compliance operations');
+    jsonOption(compliance.command('rules').description('List compliance rules')).action(async (options) => {
+        const json = options.json ?? false;
+        await runAction(json, async () => {
+            const { client } = makeClient(json);
+            const data = await withSpinner(json, 'Fetching compliance rules', () => client.compliance.rules());
+            printResult(json, data);
+        });
+    });
+    jsonOption(compliance.command('check').description('Show all compliance rules for review').argument('<issuer>', 'issuer name')).action(async (issuer, options) => {
+        const json = options.json ?? false;
+        await runAction(json, async () => {
+            const { client } = makeClient(json);
+            const data = await withSpinner(json, `Fetching compliance rules for ${issuer}`, () => client.compliance.rules());
+            printResult(json, data);
+        });
+    });
+    return program;
+}
+/**
+ * Runs the CLI with the given argv and returns the process exit code.
+ * Used by the bin entry and by tests (no `process.exit` inside).
+ */
+export async function runCli(opts) {
+    const program = buildProgram();
+    program.exitOverride();
+    program.configureOutput({
+        writeOut: opts.stdout,
+        writeErr: opts.stderr,
+    });
+    try {
+        await program.parseAsync(opts.argv);
+        return 0;
+    }
+    catch (error) {
+        const candidate = error;
+        if (candidate.code === 'commander.helpDisplayed' || candidate.code === 'commander.help') {
+            return 0;
+        }
+        if (candidate.code === 'commander.version') {
+            return 0;
+        }
+        if (typeof candidate.exitCode === 'number') {
+            return candidate.exitCode;
+        }
+        const message = candidate.message ?? 'unexpected error';
+        opts.stderr(message);
+        return 1;
+    }
+}
+const entry = process.argv[1];
+const isDirectRun = entry !== undefined && import.meta.url === pathToFileURL(entry).href;
+if (isDirectRun) {
+    runCli({
+        argv: process.argv,
+        stdout: (line) => process.stdout.write(line),
+        stderr: (line) => process.stderr.write(line),
+    })
+        .then((code) => {
+        process.exitCode = code;
+    })
+        .catch((error) => {
+        process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/output.d.ts

@@ -0,0 +1,24 @@
+import { Flowgate } from '@iflowgate/sdk';
+/** Exit code used when FLOWGATE_API_KEY is missing. */
+export declare const MISSING_KEY_EXIT = 1;
+/** Error with a message already rendered for the terminal. */
+export declare class CliError extends Error {
+    readonly exitCode: number;
+    constructor(message: string, exitCode?: number);
+}
+export interface CommandContext {
+    client: Flowgate;
+    json: boolean;
+}
+/**
+ * Asserts FLOWGATE_API_KEY is present and builds the SDK client with it.
+ * Throws {@link CliError} (red message) when the variable is missing.
+ */
+export declare function requireClient(json: boolean): CommandContext;
+/** Runs `task`, showing a spinner unless `--json` output was requested. */
+export declare function withSpinner<T>(json: boolean, text: string, task: () => Promise<T>): Promise<T>;
+/** Prints a value as pretty JSON (spinner mode) or compact JSON (pipe mode). */
+export declare function printResult(json: boolean, value: unknown): void;
+/** Prints an error in red and returns the exit code to use. */
+export declare function handleError(error: unknown, json: boolean): number;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAiB,MAAM,gBAAgB,CAAC;AAEzD,uDAAuD;AACvD,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,8DAA8D;AAC9D,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAI;CAK1C;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,QAAQ,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAM3D;AAED,2EAA2E;AAC3E,wBAAsB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAapG;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAM/D;AAED,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAgBjE"}

package/dist/output.js

@@ -0,0 +1,75 @@
+/**
+ * Shared CLI helpers: environment handling, spinner-wrapped execution,
+ * pretty/compact JSON output, and red error rendering.
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+import { Flowgate, FlowgateError } from '@iflowgate/sdk';
+/** Exit code used when FLOWGATE_API_KEY is missing. */
+export const MISSING_KEY_EXIT = 1;
+/** Error with a message already rendered for the terminal. */
+export class CliError extends Error {
+    exitCode;
+    constructor(message, exitCode = 1) {
+        super(message);
+        this.name = 'CliError';
+        this.exitCode = exitCode;
+    }
+}
+/**
+ * Asserts FLOWGATE_API_KEY is present and builds the SDK client with it.
+ * Throws {@link CliError} (red message) when the variable is missing.
+ */
+export function requireClient(json) {
+    const apiKey = process.env.FLOWGATE_API_KEY;
+    if (apiKey === undefined || apiKey === '') {
+        throw new CliError(chalk.red('FLOWGATE_API_KEY is not set. Export it before running this command.'));
+    }
+    return { client: new Flowgate({ apiKey }), json };
+}
+/** Runs `task`, showing a spinner unless `--json` output was requested. */
+export async function withSpinner(json, text, task) {
+    if (json) {
+        return task();
+    }
+    const spinner = ora(text).start();
+    try {
+        const result = await task();
+        spinner.succeed();
+        return result;
+    }
+    catch (error) {
+        spinner.fail();
+        throw error;
+    }
+}
+/** Prints a value as pretty JSON (spinner mode) or compact JSON (pipe mode). */
+export function printResult(json, value) {
+    if (json) {
+        process.stdout.write(`${JSON.stringify(value)}\n`);
+        return;
+    }
+    process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+}
+/** Prints an error in red and returns the exit code to use. */
+export function handleError(error, json) {
+    let message;
+    if (error instanceof FlowgateError) {
+        const hint = error.status === 401 ? ' (check FLOWGATE_API_KEY)' : '';
+        message = `${error.endpoint} -> ${error.status}: ${error.detail}${hint}`;
+    }
+    else if (error instanceof CliError) {
+        message = error.message;
+    }
+    else {
+        message = error instanceof Error ? error.message : String(error);
+    }
+    if (json) {
+        process.stderr.write(`${JSON.stringify({ error: message })}\n`);
+    }
+    else {
+        process.stderr.write(`${chalk.red(message)}\n`);
+    }
+    return error instanceof CliError ? error.exitCode : 1;
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEzD,uDAAuD;AACvD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAElC,8DAA8D;AAC9D,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,QAAQ,CAAS;IAE1B,YAAY,OAAe,EAAE,QAAQ,GAAG,CAAC;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAOD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC5C,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;QAC1C,MAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,qEAAqE,CAAC,CAAC,CAAC;IACvG,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,IAAI,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;AACpD,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,KAAK,UAAU,WAAW,CAAI,IAAa,EAAE,IAAY,EAAE,IAAsB;IACtF,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,IAAI,EAAE,CAAC;IAChB,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;QAC5B,OAAO,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,WAAW,CAAC,IAAa,EAAE,KAAc;IACvD,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnD,OAAO;IACT,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,IAAa;IACvD,IAAI,OAAe,CAAC;IACpB,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,OAAO,GAAG,GAAG,KAAK,CAAC,QAAQ,OAAO,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;IAC3E,CAAC;SAAM,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QACrC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;IAClE,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,KAAK,YAAY,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC"}

package/package.json

@@ -1,6 +1,43 @@
 {
   "name": "@iflowgate/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "Flowgate command-line interface.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "bin": {
+    "flowgate": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/titouhalloub/flowgate-sdk.git"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@iflowgate/sdk": "0.1.1",
+    "chalk": "5.6.2",
+    "commander": "12.1.0",
+    "ora": "8.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "20.19.30",
+    "typescript": "5.9.3",
+    "vitest": "3.2.7"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "tsc --noEmit",
+    "regen": "echo \"@iflowgate/cli: no schema to regen\""
+  }
 }