@hyper3d/cli 0.0.1 → 0.1.0-beta.2.1

package/README.md

@@ -1,7 +1,170 @@
-# Hyper3D CLI — initialization placeholder
+# Hyper3D CLI
 
-Version 0.0.1 is a minimal package used to initialize the npm package and configure trusted publishing from GitHub Actions.
+Generate 3D models from text or images, follow their progress, and get the finished
+files from your terminal.
 
-This version does not contain a CLI executable or runtime functionality. It is published under the `init` dist-tag. Use a subsequent functional release to run the Hyper3D CLI.
+## Install
 
-Source: https://github.com/DeemosTech/hyper3d-cli
+Requires **Node.js 22 or newer**. The package is being prepared for its first npm
+release; the registry commands below become available after that release.
+
+```sh
+npm install --global @hyper3d/cli
+hyper3d --help
+```
+
+You can also use pnpm or Yarn, or run the CLI without a global installation:
+
+```sh
+pnpm add --global @hyper3d/cli
+# Yarn Classic
+yarn global add @hyper3d/cli
+# Run once with npm, pnpm, or modern Yarn
+npx @hyper3d/cli@latest --help
+pnpm dlx @hyper3d/cli@latest --help
+yarn dlx @hyper3d/cli@latest --help
+```
+
+For a project-local installation, run `npm install --save-dev @hyper3d/cli`, then
+`npx hyper3d --help`. To try the latest beta build, use `@hyper3d/cli@beta`
+in place of `@hyper3d/cli`.
+
+## Sign in
+
+```sh
+hyper3d auth login
+```
+
+Compare the code shown in your terminal with the browser, then approve access.
+On a remote machine, use `hyper3d auth login --no-browser` and open the printed link
+on another device. Press Ctrl+C to cancel.
+
+```sh
+hyper3d auth status   # Account and credit balances
+hyper3d auth logout   # Remove saved credentials from this machine
+```
+
+Credentials are saved in `~/.hyper3d` by default and refreshed automatically when
+needed. Set `HYPER3D_CONFIG_DIR` to use a different directory.
+Signing out locally does not revoke your server-side authorization.
+
+## Generate a model
+
+Generation uses credits from your authorized workspace.
+
+```sh
+# From text
+hyper3d generate --prompt "a ceramic teapot" --format glb
+
+# From one image
+hyper3d generate --image ./reference.png
+
+# From multiple views, with an optional description
+hyper3d generate --image ./front.png --image ./side.jpg --prompt "a ceramic teapot"
+```
+
+You can provide up to five images. The response includes a generation ID; use it
+to check progress and retrieve the result:
+
+```sh
+hyper3d status <generation-id>
+hyper3d poll <generation-id> --timeout 300
+hyper3d result <generation-id>
+```
+
+`poll` waits up to the requested number of seconds. `result` returns download URLs;
+it does not download files to your machine.
+
+To separate a completed model into parts:
+
+```sh
+hyper3d bang <generation-id> --instruction "separate the handle and lid"
+```
+
+Run `hyper3d <command> --help` for more options. If a generation request times out,
+check your existing tasks before submitting it again; the CLI never retries
+billable generation automatically.
+
+## Use JSON output
+
+Output is readable text by default. Add `--output json` for scripts:
+
+```sh
+hyper3d auth status --output json
+hyper3d generate --prompt "a ceramic teapot" --output json
+hyper3d status <generation-id> --output json
+```
+
+Warnings and errors go to stderr. Successful commands exit with code `0`; errors
+exit with code `1`.
+
+## Updates
+
+```sh
+hyper3d update --check
+hyper3d update
+```
+
+An interactive **npm global installation** checks for updates once a day before
+model commands and only displays an update notice by default. Stable installations
+follow `latest`; prerelease-branch builds follow `beta`. Run `hyper3d update` to install
+an available update.
+
+Set `HYPER3D_AUTO_UPDATE=1` to opt into automatic installation (which asks you to
+rerun your command before submitting the model operation), or
+`HYPER3D_UPDATE_CHECK=0` to disable automatic checks and automatic installation.
+These switches require the exact values `1` and `0`, respectively. Automatic checks
+and installation are also skipped when `CI` is nonempty (including `CI=0`) or stderr
+is not a TTY. These settings do not disable manual `hyper3d update` or
+`hyper3d update --check`. Network failures leave your command usable.
+
+For pnpm, Yarn, or project-local installations, update with the package manager
+that installed the CLI. For one-off runs, specify `@latest`:
+
+```sh
+pnpm add --global @hyper3d/cli@latest
+yarn global add @hyper3d/cli@latest  # Yarn Classic
+npm install --save-dev @hyper3d/cli@latest
+npx @hyper3d/cli@latest --help
+```
+
+To switch channels explicitly, install `@hyper3d/cli@latest` or
+`@hyper3d/cli@beta` with your package manager. `hyper3d update` only upgrades to a
+newer version and never downgrades a pinned installation.
+
+## Troubleshooting
+
+- **Not signed in or access denied:** run `hyper3d auth login` again. Check that you
+  authorized the intended personal or team workspace.
+- **Browser does not open:** follow the printed link, or use `--no-browser`.
+- **Command not found:** check that your package manager's global bin directory is
+  on `PATH`, or use `npx @hyper3d/cli@latest`.
+- **Update permission error:** update with the package manager and permissions used
+  for the original installation.
+- **An interrupted update leaves future checks inactive:** close other CLI
+  processes and remove the empty `update.lock` directory inside your configuration
+  directory (`~/.hyper3d` by default, or the directory set by `HYPER3D_CONFIG_DIR`),
+  then run `hyper3d update`.
+
+The API base URL defaults to `https://api.hyper3d.com/api`. Set `BASE_URL` to
+use another environment; a trailing slash is optional:
+
+```sh
+BASE_URL=https://api.hyper3d.com/api/ hyper3d auth status
+hyper3d --base-url https://api.hyper3d.com/api auth status
+```
+
+`--base-url` overrides `BASE_URL`. MCP (`mcp`), account (`user/get_info`) and
+team (`group/group_info`) endpoints are derived from this base. HTTPS is required
+except for localhost. OAuth endpoints remain server-discovered, and upload/result
+URLs remain server-provided.
+
+`HYPER3D_CONFIG_DIR` changes the directory for credentials, the update cache
+(`update-check.json`), and the update lock (`update.lock`). If unset, it defaults to
+`~/.hyper3d`. Relative paths resolve from the current working directory; an empty
+value uses the current working directory rather than the default. Use a nonempty
+absolute path for a consistent location across commands.
+
+For development and releases, see [CONTRIBUTING.md](https://github.com/DeemosTech/hyper3d-cli/blob/main/CONTRIBUTING.md) and the
+[release guide](https://github.com/DeemosTech/hyper3d-cli/blob/main/docs/releasing.md). Report problems in
+[GitHub Issues](https://github.com/DeemosTech/hyper3d-cli/issues).

package/dist/account.d.ts

@@ -0,0 +1,26 @@
+export declare function accountInfo({ fetchFn }?: {
+    fetchFn?: typeof fetch | undefined;
+}): Promise<{
+    authenticated: boolean;
+    user?: undefined;
+    wallet?: undefined;
+} | {
+    authenticated: boolean;
+    user: {
+        uuid: string;
+        username: string;
+    };
+    wallet: {
+        subscription_balance: number;
+        balance: number;
+        frozen: number;
+        type: "personal";
+    } | {
+        subscription_balance?: number | undefined;
+        balance: number;
+        frozen: number;
+        type: "group";
+        group_uuid: string;
+        name?: string;
+    };
+}>;

package/dist/account.js

@@ -0,0 +1,136 @@
+import { auth } from '@modelcontextprotocol/sdk/client/auth.js';
+import { z } from 'zod';
+import { loadCredentials, createProvider } from './auth.js';
+import { endpoints, secureUrl } from './endpoints.js';
+const WALLET_UNITS_PER_CREDIT = 10;
+const identitySchema = z.object({
+    user_uuid: z.string().min(1),
+    username: z.string(),
+});
+const personalMetaSchema = identitySchema.extend({
+    balance: z.number(),
+    frozen: z.number(),
+    subscriptions: z.object({
+        active_subscriptions: z.array(z.object({ wallet_balance: z.number() })),
+    }),
+});
+const accountResponseSchema = z.object({
+    meta: identitySchema.passthrough(),
+    billing_workspace: z.discriminatedUnion('type', [
+        z.object({ type: z.literal('personal') }),
+        z.object({ type: z.literal('group'), group_uuid: z.string().min(1) }),
+    ]),
+});
+const groupResponseSchema = z.object({
+    group_meta: z.object({
+        uuid: z.string().min(1),
+        name: z.string().optional(),
+        frozen: z.number(),
+    }),
+    balance: z.number(),
+});
+function parseResponse(schema, data) {
+    const result = schema.safeParse(data);
+    if (!result.success) {
+        const details = result.error.issues
+            .map((issue) => `${issue.path.join('.')}: ${issue.message}`)
+            .join('; ');
+        throw new Error(`Invalid account response: ${details}`);
+    }
+    return result.data;
+}
+export async function accountInfo({ fetchFn = fetch } = {}) {
+    const endpoint = endpoints.mcp;
+    const data = await loadCredentials(endpoint);
+    const provider = data.clientId ? createProvider(endpoint, data) : undefined;
+    let accessToken = data.tokens?.access_token;
+    if (!accessToken)
+        return { authenticated: false };
+    const request = async (input, init = {}) => {
+        secureUrl(input);
+        return fetchFn(input, {
+            ...init,
+            redirect: 'error',
+            signal: AbortSignal.timeout(15000),
+        });
+    };
+    let refreshed = false;
+    const post_with_optional_token_refresh = async (path, body) => {
+        const send = async () => request(path, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${accessToken}`,
+                'Content-Type': 'application/json',
+                Accept: 'application/json',
+            },
+            body: JSON.stringify(body),
+        });
+        let response = await send();
+        if (response.status === 401 &&
+            !refreshed &&
+            provider &&
+            data.tokens?.refresh_token) {
+            refreshed = true;
+            await response.body?.cancel();
+            await auth(provider, { serverUrl: endpoint, fetchFn: request });
+            accessToken = provider.tokens()?.access_token;
+            response = await send();
+        }
+        if (!response.ok) {
+            await response.body?.cancel();
+            if ([401, 403].includes(response.status))
+                throw new Error('Account access denied. Run hyper3d auth login to authorize account:read and an available billing workspace.');
+            throw new Error(`Account lookup failed (HTTP ${response.status}).`);
+        }
+        const result = await response.json();
+        if (result.error)
+            throw new Error(`Account lookup failed: ${result.error}`);
+        return result;
+    };
+    const { meta, billing_workspace: workspace } = parseResponse(accountResponseSchema, await post_with_optional_token_refresh(endpoints.userInfo, {}));
+    let wallet;
+    switch (workspace.type) {
+        case 'personal': {
+            const personal = parseResponse(personalMetaSchema, meta);
+            const subscriptionBalance = personal.subscriptions.active_subscriptions.reduce((total, subscription) => total + subscription.wallet_balance, 0);
+            wallet = {
+                type: 'personal',
+                balance: personal.balance,
+                subscription_balance: subscriptionBalance,
+                frozen: personal.frozen,
+            };
+            break;
+        }
+        case 'group': {
+            const result = parseResponse(groupResponseSchema, await post_with_optional_token_refresh(endpoints.groupInfo, {
+                group_uuid: workspace.group_uuid,
+            }));
+            if (result.group_meta?.uuid !== workspace.group_uuid)
+                throw new Error('The returned wallet does not match the authorized billing workspace.');
+            wallet = {
+                type: 'group',
+                group_uuid: workspace.group_uuid,
+                name: result.group_meta.name,
+                balance: result.balance,
+                frozen: result.group_meta.frozen,
+            };
+            break;
+        }
+    }
+    const displayedWallet = {
+        ...wallet,
+        balance: wallet.balance / WALLET_UNITS_PER_CREDIT,
+        frozen: wallet.frozen / WALLET_UNITS_PER_CREDIT,
+        ...(wallet.type === 'personal'
+            ? {
+                subscription_balance: wallet.subscription_balance / WALLET_UNITS_PER_CREDIT,
+            }
+            : {}),
+    };
+    return {
+        authenticated: true,
+        user: { uuid: meta.user_uuid, username: meta.username },
+        wallet: displayedWallet,
+    };
+}
+//# sourceMappingURL=account.js.map

package/dist/account.js.map

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

package/dist/auth.d.ts

@@ -0,0 +1,63 @@
+import { setTimeout as sleep } from 'node:timers/promises';
+import type { Credentials } from './types.js';
+import type { OAuthTokens } from '@modelcontextprotocol/sdk/shared/auth.js';
+interface LoginOptions {
+    browser?: boolean;
+    fetchFn?: typeof fetch;
+    open?: (url: string) => Promise<void>;
+    write?: (text: string) => unknown;
+    wait?: typeof sleep;
+    now?: () => number;
+    signal?: AbortSignal;
+}
+export declare const DEVICE_GRANT_TYPE = "urn:ietf:params:oauth:grant-type:device_code";
+export declare const CLI_CLIENT_ID = "https://hyper3d.ai/oauth_cimd/cli.json";
+export declare const CLI_SCOPES = "rodin:generate rodin:read account:read offline_access";
+export declare function clientMetadata(): {
+    client_id: string;
+    client_name: string;
+    client_uri: string;
+    application_type: string;
+    redirect_uris: never[];
+    grant_types: string[];
+    response_types: never[];
+    token_endpoint_auth_method: string;
+    scope: string;
+};
+export declare function credentialPath(endpoint: string): string;
+export declare function loadCredentials(endpoint: string): Promise<Credentials>;
+export declare function logout(endpoint: string): Promise<void>;
+export declare function createProvider(endpoint: string, data: Credentials): {
+    redirectUrl: undefined;
+    saveCodeVerifier: () => Promise<never>;
+    codeVerifier: () => Promise<string>;
+    clientMetadataUrl: string;
+    readonly clientMetadata: Omit<{
+        client_id: string;
+        client_name: string;
+        client_uri: string;
+        application_type: string;
+        redirect_uris: never[];
+        grant_types: string[];
+        response_types: never[];
+        token_endpoint_auth_method: string;
+        scope: string;
+    }, "client_id">;
+    clientInformation: () => {
+        client_id: string;
+    };
+    tokens: () => {
+        access_token: string;
+        token_type: string;
+        id_token?: string | undefined;
+        expires_in?: number | undefined;
+        scope?: string | undefined;
+        refresh_token?: string | undefined;
+    } | undefined;
+    saveTokens: (tokens: OAuthTokens) => Promise<void>;
+    prepareTokenRequest: () => URLSearchParams;
+    redirectToAuthorization: () => never;
+    invalidateCredentials: (scope: string) => Promise<void>;
+};
+export declare function login(endpoint: string, { browser, fetchFn, open, write, wait, now, signal, }?: LoginOptions): Promise<void>;
+export {};