@ratio-app/cli 0.1.1

package/dist/commands/app/link.d.ts

@@ -0,0 +1,118 @@
+import * as _oclif_core_interfaces from '@oclif/core/interfaces';
+import { z } from 'zod';
+import { CredentialStore } from '../../lib/credentials/store.js';
+import { RatioCommand } from '../../lib/ratio-command.js';
+import '../../lib/credentials/clock.js';
+import '../../lib/credentials/refresher.js';
+import '../../lib/credentials/types.js';
+import '@oclif/core';
+
+/** Per-request budget for platform HTTP calls; slower responses time out. */
+declare const REQUEST_TIMEOUT_MS = 10000;
+/** Compiled-in default server for app-link when nothing else resolves. */
+declare const DEFAULT_LINK_SERVER = "https://api.ratio.app";
+/** Developer sessions live 24 hours from issue; computed at persist time. */
+declare const DEVELOPER_SESSION_TTL_MS: number;
+/** Fallback description when the user provides none at create time. */
+declare const DEFAULT_APP_DESCRIPTION = "A Ratio app scaffolded via ratio-cli.";
+/** Default category slug used at create time; override with --category. */
+declare const DEFAULT_CATEGORY_SLUG = "general";
+declare const signinResponseSchema: z.ZodObject<{
+    accessToken: z.ZodString;
+    developer: z.ZodObject<{
+        id: z.ZodString;
+        email: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+        email: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        email: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>;
+}, "strip", z.ZodTypeAny, {
+    accessToken: string;
+    developer: {
+        email: string;
+        id: string;
+    } & {
+        [k: string]: unknown;
+    };
+}, {
+    accessToken: string;
+    developer: {
+        email: string;
+        id: string;
+    } & {
+        [k: string]: unknown;
+    };
+}>;
+type SigninResponse = z.infer<typeof signinResponseSchema>;
+declare const applicationSummarySchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    clientId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodString;
+    name: z.ZodString;
+    clientId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodString;
+    name: z.ZodString;
+    clientId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.ZodTypeAny, "passthrough">>;
+type ApplicationSummary = z.infer<typeof applicationSummarySchema>;
+/** Compute the session expiry from the moment the token was obtained. */
+declare function computeSessionExpiresAt(obtainedAtIso: string): string;
+/** Interactive input seam. Tests inject a scripted fake. */
+interface LinkPrompter {
+    /** Ask a visible-echo question (email, name, selection). */
+    text(question: string): Promise<string>;
+    /** Ask a masked question (password). Input is never echoed. */
+    masked(question: string): Promise<string>;
+}
+/**
+ * Production prompter. Questions render on stderr so stdout stays reserved
+ * for the final human line or the machine-readable JSON envelope. The masked
+ * variant reads raw stdin and never echoes a character; the entered value is
+ * never logged and never persisted.
+ */
+declare function defaultLinkPrompter(): LinkPrompter;
+declare class AppLink extends RatioCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        email: _oclif_core_interfaces.OptionFlag<string | undefined, _oclif_core_interfaces.CustomOptions>;
+        'client-id': _oclif_core_interfaces.OptionFlag<string | undefined, _oclif_core_interfaces.CustomOptions>;
+        'app-id': _oclif_core_interfaces.OptionFlag<string | undefined, _oclif_core_interfaces.CustomOptions>;
+        category: _oclif_core_interfaces.OptionFlag<string | undefined, _oclif_core_interfaces.CustomOptions>;
+        json: _oclif_core_interfaces.BooleanFlag<boolean>;
+        verbose: _oclif_core_interfaces.BooleanFlag<boolean>;
+    };
+    writeOut: (chunk: string) => void;
+    writeErr: (chunk: string) => void;
+    makeCredentialStore: () => CredentialStore;
+    prompter: LinkPrompter;
+    isInteractive: () => boolean;
+    envReader: () => Readonly<Record<string, string | undefined>>;
+    getCwd: () => string;
+    run(): Promise<void>;
+    private readManifest;
+    private writeAndReport;
+    private resolveServer;
+    private acquireBearer;
+    private signinInteractive;
+    private signin;
+    /**
+     * Run one app-management call; on a 401 re-prompt the password ONCE
+     * (email already known when possible), retry ONCE, and fail typed on a
+     * second 401. Unattended runs (env token / non-TTY) fail typed directly.
+     */
+    private withAuthRetry;
+    private fetchAppClientId;
+    private listApplications;
+    private createApplication;
+    private pickOrCreateApp;
+    private createFlow;
+}
+
+export { type ApplicationSummary, DEFAULT_APP_DESCRIPTION, DEFAULT_CATEGORY_SLUG, DEFAULT_LINK_SERVER, DEVELOPER_SESSION_TTL_MS, type LinkPrompter, REQUEST_TIMEOUT_MS, type SigninResponse, computeSessionExpiresAt, AppLink as default, defaultLinkPrompter };