@amerged/ohmyhost-cli 0.1.10 → 0.1.11

package/README.md

@@ -1,6 +1,6 @@
 # @amerged/ohmyhost-cli
 
-ohmyho.st cli client, version 0.1.10.
+ohmyho.st cli client, version 0.1.11.
 
 ```sh
 npm install --global @amerged/ohmyhost-cli

package/dist/bin.js

@@ -2,7 +2,7 @@
 import { createRequire as __ohmyhostCreateRequire } from "node:module"; const require = __ohmyhostCreateRequire(import.meta.url);
 import {
   runProductionCli
-} from "./chunk-Z75ASLEB.js";
+} from "./chunk-WT2RRQUB.js";
 import "./chunk-4HFQ54FP.js";
 
 // apps/product-cli/dist/bin.js

package/dist/{chunk-Z75ASLEB.js → chunk-WT2RRQUB.js}

@@ -15000,6 +15000,8 @@ var recognizedCommandLabel = (argv) => {
       return "project notes set";
     if (value === "project" && values[0] === "status")
       return "project status";
+    if (value === "project" && values[0] === "handle" && values[1] === "check")
+      return "project handle check";
     if (value === "project" && values[0] === "dev-access" && values[1] === "create")
       return "project dev-access create";
     if (value === "database" && values[0] === "compute" && values[1] === "set")
@@ -15442,6 +15444,12 @@ var parseProductCliCommand = (argv) => {
   }
   if (first === "project") {
     const subcommand = values.shift();
+    if (subcommand === "handle" && values.shift() === "check") {
+      if (yes || wait || follow || stdin)
+        throw new InvalidCommandError();
+      const options2 = parseOptions(values, ["--handle"]);
+      return { kind: "project-handle-check", handle: options2["--handle"], credentialStore };
+    }
     if (subcommand === "dev-access" && values.shift() === "create") {
       if (yes || wait || follow || stdin)
         throw new InvalidCommandError();
@@ -16517,7 +16525,7 @@ function assertOrganizationAccount(value) {
   if (!value || typeof value !== "object" || Array.isArray(value) || Object.keys(value).sort().join(",") !== "as_of,available_micros,monthly_micros,name,next_expiry,one_time_micros,organization_id,paid_until,plan,plan_source,reserved_micros,workos_organization_id")
     throw new TypeError("Invalid account fields");
   const v = value;
-  if (typeof v["organization_id"] !== "string" || !/^[0-7][0-9A-HJKMNP-TV-Z]{25}$/u.test(v["organization_id"]) || typeof v["name"] !== "string" || v["name"].length > 128 || typeof v["workos_organization_id"] !== "string" || !/^org_[A-Za-z0-9_]+$/u.test(v["workos_organization_id"]) || v["plan"] !== "paid" && v["plan"] !== "free" || !["free", "stripe", "beta", "manual"].includes(String(v["plan_source"])) || v["plan"] === "free" !== (v["plan_source"] === "free"))
+  if (typeof v["organization_id"] !== "string" || !/^[0-7][0-9A-HJKMNP-TV-Z]{25}$/u.test(v["organization_id"]) || typeof v["name"] !== "string" || v["name"].length > 128 || typeof v["workos_organization_id"] !== "string" || !/^org_[A-Za-z0-9_]+$/u.test(v["workos_organization_id"]) || v["plan"] !== "paid" && v["plan"] !== "free" || !["free", "stripe", "granted", "manual"].includes(String(v["plan_source"])) || v["plan"] === "free" !== (v["plan_source"] === "free"))
     throw new TypeError("Invalid account scope");
   for (const field of ["available_micros", "monthly_micros", "one_time_micros", "reserved_micros"])
     if (typeof v[field] !== "string" || !/^(0|[1-9][0-9]{0,18})$/u.test(v[field]))
@@ -17810,7 +17818,7 @@ function exact2(v, keys) {
 // apps/product-cli/package.json
 var package_default = {
   name: "@ohmyhost/product-cli",
-  version: "0.1.10",
+  version: "0.1.11",
   private: true,
   ohmyhost: {
     deployment: "production",
@@ -18173,6 +18181,7 @@ var HELP_USAGE = Object.freeze({
   "project notes set": "ohmyhost project notes set --project ULID --version NUMBER --markdown TEXT --idempotency-key KEY --json (no credentials or signed URLs)",
   "project status": "ohmyhost project status --project ULID --json",
   "project dev-access create": "ohmyhost project dev-access create --project ULID --json",
+  "project handle check": "ohmyhost project handle check --handle HANDLE --json (is this address free? answers with a reason and free alternatives; the address becomes HANDLE.check.omh.st)",
   "database compute set": "ohmyhost database compute set --project ULID --environment dev|prod --profile standard|performance --idempotency-key KEY --yes [--wait] --json\n  standard: Free 0.25 CU/1 GB/60s idle, Paid 0.5 CU/2 GB/60s idle. performance: Paid 1 CU/4 GB/300s idle, 2.5x database compute credits per equal active minute; longer idle time also consumes credits.",
   "database compute get": "ohmyhost database compute get --project ULID [--environment dev|prod] --json",
   "database write": "ohmyhost database write --project ULID --environment dev|prod --statement-file PATH --idempotency-key KEY [--parameters-json JSON] --yes --json",
@@ -18447,6 +18456,8 @@ var ProductCli = class {
         return await this.createProject(command, signal);
       if (command.kind === "project-list")
         return await this.listProjects(command, signal);
+      if (command.kind === "project-handle-check")
+        return await this.checkProjectHandle(command, signal);
       if (command.kind === "database-compute-set") {
         const api = await this.authenticatedApi(command.credentialStore, signal);
         let operation = parseOperation(await api.changeDatabaseCompute(command));
@@ -18786,6 +18797,11 @@ var ProductCli = class {
     }));
     return success("project list", { status: "succeeded", projects });
   }
+  async checkProjectHandle(command, signal) {
+    const api = await this.authenticatedApi(command.credentialStore, signal);
+    const handle = await api.checkProjectHandle({ handle: command.handle });
+    return success("project handle check", { status: "succeeded", handle });
+  }
   async getProjectStatus(command, signal) {
     const api = await this.authenticatedApi(command.credentialStore, signal);
     const project = parseProjectStatus(await api.getProjectStatus(command.projectId));
@@ -19390,6 +19406,8 @@ var parsedCommandName = (command) => {
     return "project status";
   if (command.kind === "project-dev-access-create")
     return "project dev-access create";
+  if (command.kind === "project-handle-check")
+    return "project handle check";
   if (command.kind === "database-write")
     return "database write";
   if (command.kind === "database-query")
@@ -20931,6 +20949,23 @@ var getProjectStatus = (parameters, options) => {
     ...params
   });
 };
+var getProjectHandleAvailability = (parameters, options) => {
+  const params = buildClientParams([parameters], [
+    {
+      args: [
+        { in: "headers", key: "X-Request-Id" },
+        { in: "path", key: "handle" }
+      ]
+    }
+  ]);
+  return (options?.client ?? client).get({
+    responseStyle: "data",
+    security: [{ scheme: "bearer", type: "http" }],
+    url: "/v1/project-handles/{handle}",
+    ...options,
+    ...params
+  });
+};
 var createProjectDevAccessTicket = (parameters, options) => {
   const params = buildClientParams([parameters], [
     {
@@ -21817,6 +21852,9 @@ var GeneratedSdkProductApi = class {
   async listProjects(input) {
     return listProjects(input, { client: this.#client });
   }
+  async checkProjectHandle(input) {
+    return getProjectHandleAvailability({ handle: input.handle }, { client: this.#client });
+  }
   async getProjectStatus(projectId) {
     return getProjectStatus({ project_id: projectId }, { client: this.#client });
   }

package/dist/index.js

@@ -47,7 +47,7 @@ import {
   selectWorkspace,
   selectedWorkspaceId,
   workspaceOf
-} from "./chunk-Z75ASLEB.js";
+} from "./chunk-WT2RRQUB.js";
 import {
   CredentialStoreIntegrityError,
   CredentialStoreUnavailableError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amerged/ohmyhost-cli",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "type": "module",
   "engines": {
     "node": ">=22"

package/src/apps/product-cli/cli.ts

@@ -310,6 +310,8 @@ const HELP_USAGE = Object.freeze({
     "ohmyhost project notes set --project ULID --version NUMBER --markdown TEXT --idempotency-key KEY --json (no credentials or signed URLs)",
   "project status": "ohmyhost project status --project ULID --json",
   "project dev-access create": "ohmyhost project dev-access create --project ULID --json",
+  "project handle check":
+    "ohmyhost project handle check --handle HANDLE --json (is this address free? answers with a reason and free alternatives; the address becomes HANDLE.check.omh.st)",
   "database compute set":
     "ohmyhost database compute set --project ULID --environment dev|prod --profile standard|performance --idempotency-key KEY --yes [--wait] --json\n" +
     "  standard: Free 0.25 CU/1 GB/60s idle, Paid 0.5 CU/2 GB/60s idle. performance: Paid 1 CU/4 GB/300s idle, 2.5x database compute credits per equal active minute; longer idle time also consumes credits.",
@@ -687,6 +689,8 @@ export class ProductCli {
       }
       if (command.kind === "project-create") return await this.createProject(command, signal);
       if (command.kind === "project-list") return await this.listProjects(command, signal);
+      if (command.kind === "project-handle-check")
+        return await this.checkProjectHandle(command, signal);
       if (command.kind === "database-compute-set") {
         const api = await this.authenticatedApi(command.credentialStore, signal);
         let operation = parseOperation(await api.changeDatabaseCompute(command));
@@ -1165,6 +1169,15 @@ export class ProductCli {
     return success("project list", { status: "succeeded", projects });
   }
 
+  private async checkProjectHandle(
+    command: Extract<ProductCliCommand, { kind: "project-handle-check" }>,
+    signal: AbortSignal,
+  ): Promise<CliResult> {
+    const api = await this.authenticatedApi(command.credentialStore, signal);
+    const handle = await api.checkProjectHandle({ handle: command.handle });
+    return success("project handle check", { status: "succeeded", handle });
+  }
+
   private async getProjectStatus(
     command: Extract<ProductCliCommand, { kind: "project-status" }>,
     signal: AbortSignal,
@@ -2115,6 +2128,7 @@ const parsedCommandName = (command: ProductCliCommand): CommandLabel => {
   if (command.kind === "project-notes-set") return "project notes set";
   if (command.kind === "project-status") return "project status";
   if (command.kind === "project-dev-access-create") return "project dev-access create";
+  if (command.kind === "project-handle-check") return "project handle check";
   if (command.kind === "database-write") return "database write";
   if (command.kind === "database-query") return "database query";
   if (command.kind === "database-access-create") return "database access create";

package/src/apps/product-cli/command.ts

@@ -132,6 +132,12 @@ export type ProductCliCommand =
       readonly idempotencyKey: string;
       readonly credentialStore: "native";
     }
+  | {
+      /** Asks whether a project address is free; the candidate is sent exactly as the agent typed it. */
+      readonly kind: "project-handle-check";
+      readonly handle: string;
+      readonly credentialStore: "native";
+    }
   | { readonly kind: "help"; readonly topic?: string }
   | { readonly kind: "version" }
   | { readonly kind: "whoami"; readonly credentialStore: "native" }
@@ -487,6 +493,7 @@ export type RecognizedCommandLabel =
   | "project list"
   | "project status"
   | "project dev-access create"
+  | "project handle check"
   | "database write"
   | "database query"
   | "database access create"
@@ -576,6 +583,8 @@ export const recognizedCommandLabel = (argv: readonly string[]): RecognizedComma
     if (value === "project" && values[0] === "notes" && values[1] === "set")
       return "project notes set";
     if (value === "project" && values[0] === "status") return "project status";
+    if (value === "project" && values[0] === "handle" && values[1] === "check")
+      return "project handle check";
     if (value === "project" && values[0] === "dev-access" && values[1] === "create")
       return "project dev-access create";
     if (value === "database" && values[0] === "compute" && values[1] === "set")
@@ -1045,6 +1054,11 @@ export const parseProductCliCommand = (argv: readonly string[]): ProductCliComma
   }
   if (first === "project") {
     const subcommand = values.shift();
+    if (subcommand === "handle" && values.shift() === "check") {
+      if (yes || wait || follow || stdin) throw new InvalidCommandError();
+      const options = parseOptions(values, ["--handle"]);
+      return { kind: "project-handle-check", handle: options["--handle"], credentialStore };
+    }
     if (subcommand === "dev-access" && values.shift() === "create") {
       if (yes || wait || follow || stdin) throw new InvalidCommandError();
       const options = parseOptions(values, ["--project"]);

package/src/apps/product-cli/product-api.ts

@@ -83,6 +83,7 @@ import {
   listEnvironmentSecrets,
   listFunctionRuns,
   listProjects,
+  getProjectHandleAvailability,
   planDeployment,
   planPaidProjectDomain,
   planDeploymentRollback,
@@ -115,6 +116,7 @@ import {
   type CurrentIdentity,
   type DevAccessTicket,
   type ProjectPage,
+  type ProjectHandleAvailability,
   type ProjectStatus,
   type PaidDomain,
   type PaidDomainPlan,
@@ -208,6 +210,7 @@ export interface ProductApi {
   /** The signed-in user's workspaces; an interactive session is required for this route. */
   getAccountProfile(): Promise<readonly PublicWorkspace[]>;
   listProjects(input: { readonly cursor?: string; readonly limit: number }): Promise<ProjectPage>;
+  checkProjectHandle(input: { readonly handle: string }): Promise<ProjectHandleAvailability>;
   getProjectStatus(projectId: string): Promise<ProjectStatus>;
   writeProjectDatabase(
     input: ProjectDatabaseWriteRequest & { projectId: string; idempotencyKey: string },
@@ -582,6 +585,12 @@ export class GeneratedSdkProductApi implements ProductApi {
     return listProjects(input, { client: this.#client });
   }
 
+  public async checkProjectHandle(input: {
+    readonly handle: string;
+  }): Promise<ProjectHandleAvailability> {
+    return getProjectHandleAvailability({ handle: input.handle }, { client: this.#client });
+  }
+
   public async getProjectStatus(projectId: string): Promise<ProjectStatus> {
     return getProjectStatus({ project_id: projectId }, { client: this.#client });
   }

package/src/packages/contracts/credit-pricing.ts

@@ -190,7 +190,7 @@ export function assertOrganizationAccount(value: unknown): void {
     typeof v["workos_organization_id"] !== "string" ||
     !/^org_[A-Za-z0-9_]+$/u.test(v["workos_organization_id"]) ||
     (v["plan"] !== "paid" && v["plan"] !== "free") ||
-    !["free", "stripe", "beta", "manual"].includes(String(v["plan_source"])) ||
+    !["free", "stripe", "granted", "manual"].includes(String(v["plan_source"])) ||
     (v["plan"] === "free") !== (v["plan_source"] === "free")
   )
     throw new TypeError("Invalid account scope");

package/src/packages/sdk-ts/generated/index.ts

@@ -42,6 +42,7 @@ export {
   getProjectContext,
   getProjectCreditBudget,
   getProjectExport,
+  getProjectHandleAvailability,
   getProjectMailDomain,
   getProjectSource,
   getProjectSourceAutoDeploy,
@@ -331,6 +332,11 @@ export type {
   GetProjectExportErrors,
   GetProjectExportResponse,
   GetProjectExportResponses,
+  GetProjectHandleAvailabilityData,
+  GetProjectHandleAvailabilityError,
+  GetProjectHandleAvailabilityErrors,
+  GetProjectHandleAvailabilityResponse,
+  GetProjectHandleAvailabilityResponses,
   GetProjectMailDomainData,
   GetProjectMailDomainError,
   GetProjectMailDomainErrors,
@@ -467,6 +473,7 @@ export type {
   ProjectExport,
   ProjectExportArchive,
   ProjectFilter,
+  ProjectHandleAvailability,
   ProjectId,
   ProjectLimit,
   ProjectMailDomain,

package/src/packages/sdk-ts/generated/sdk.gen.ts

@@ -100,6 +100,8 @@ import type {
   GetProjectErrors,
   GetProjectExportErrors,
   GetProjectExportResponses,
+  GetProjectHandleAvailabilityErrors,
+  GetProjectHandleAvailabilityResponses,
   GetProjectMailDomainErrors,
   GetProjectMailDomainResponses,
   GetProjectResponses,
@@ -447,7 +449,7 @@ export const getFeatureInterests = <ThrowOnError extends boolean = true>(
     "data"
   >({
     responseStyle: "data",
-    url: "/v1/beta/feature-interests",
+    url: "/v1/site/feature-interests",
     ...options,
     ...params,
   });
@@ -492,7 +494,7 @@ export const registerFeatureInterest = <ThrowOnError extends boolean = true>(
     "data"
   >({
     responseStyle: "data",
-    url: "/v1/beta/feature-interests",
+    url: "/v1/site/feature-interests",
     ...options,
     ...params,
     headers: {
@@ -521,7 +523,7 @@ export const getPublicDeploymentStats = <ThrowOnError extends boolean = true>(
     "data"
   >({
     responseStyle: "data",
-    url: "/v1/beta/stats",
+    url: "/v1/site/stats",
     ...options,
   });
 
@@ -1682,6 +1684,48 @@ export const getProjectStatus = <ThrowOnError extends boolean = true>(
   });
 };
 
+/**
+ * Check whether a project handle is free
+ *
+ * Reports whether a handle can be used for a project and why not when it cannot, with free alternatives an agent can offer. A handle is one to five lowercase words of letters and digits separated by single hyphens, three to fifty-nine characters, and never one of the reserved words. Availability is answered across all projects without revealing which organization holds a taken handle.
+ */
+export const getProjectHandleAvailability = <ThrowOnError extends boolean = true>(
+  parameters: {
+    "X-Request-Id"?: string;
+    handle: string;
+  },
+  options?: Options<never, ThrowOnError>,
+): RequestResult<
+  GetProjectHandleAvailabilityResponses,
+  GetProjectHandleAvailabilityErrors,
+  ThrowOnError,
+  "data"
+> => {
+  const params = buildClientParams(
+    [parameters],
+    [
+      {
+        args: [
+          { in: "headers", key: "X-Request-Id" },
+          { in: "path", key: "handle" },
+        ],
+      },
+    ],
+  );
+  return (options?.client ?? client).get<
+    GetProjectHandleAvailabilityResponses,
+    GetProjectHandleAvailabilityErrors,
+    ThrowOnError,
+    "data"
+  >({
+    responseStyle: "data",
+    security: [{ scheme: "bearer", type: "http" }],
+    url: "/v1/project-handles/{handle}",
+    ...options,
+    ...params,
+  });
+};
+
 /**
  * Create a single-use dev access ticket
  *

package/src/packages/sdk-ts/generated/types.gen.ts

@@ -807,7 +807,7 @@ export type OrganizationAccount = {
   name: string;
   workos_organization_id: string;
   plan: "free" | "paid";
-  plan_source: "free" | "stripe" | "beta" | "manual";
+  plan_source: "free" | "stripe" | "granted" | "manual";
   paid_until: string | null;
   available_micros: CreditMicros;
   monthly_micros: CreditMicros;
@@ -845,6 +845,25 @@ export type ProjectEnvironment = {
   name: string;
 };
 
+export type ProjectHandleAvailability = {
+  /**
+   * The handle exactly as it was asked about.
+   */
+  handle: string;
+  /**
+   * True when a project may take this handle now.
+   */
+  available: boolean;
+  /**
+   * Why the handle cannot be used. Absent when it is available.
+   */
+  reason?: "taken" | "too_short" | "too_long" | "invalid_shape" | "prohibited_word";
+  /**
+   * Free handles to offer instead, empty when the handle is available.
+   */
+  alternatives: Array<string>;
+};
+
 export type ProjectStatus = {
   project_id: Ulid;
   handle: string;
@@ -1589,7 +1608,7 @@ export type GetFeatureInterestsData = {
   };
   path?: never;
   query?: never;
-  url: "/v1/beta/feature-interests";
+  url: "/v1/site/feature-interests";
 };
 
 export type GetFeatureInterestsErrors = {
@@ -1633,7 +1652,7 @@ export type RegisterFeatureInterestData = {
   };
   path?: never;
   query?: never;
-  url: "/v1/beta/feature-interests";
+  url: "/v1/site/feature-interests";
 };
 
 export type RegisterFeatureInterestErrors = {
@@ -1683,7 +1702,7 @@ export type GetPublicDeploymentStatsData = {
   body?: never;
   path?: never;
   query?: never;
-  url: "/v1/beta/stats";
+  url: "/v1/site/stats";
 };
 
 export type GetPublicDeploymentStatsErrors = {
@@ -3255,6 +3274,60 @@ export type GetProjectStatusResponses = {
 
 export type GetProjectStatusResponse = GetProjectStatusResponses[keyof GetProjectStatusResponses];
 
+export type GetProjectHandleAvailabilityData = {
+  body?: never;
+  headers?: {
+    /**
+     * Optional caller-provided correlation identifier.
+     */
+    "X-Request-Id"?: string;
+  };
+  path: {
+    /**
+     * The handle a customer would like to use.
+     */
+    handle: string;
+  };
+  query?: never;
+  url: "/v1/project-handles/{handle}";
+};
+
+export type GetProjectHandleAvailabilityErrors = {
+  /**
+   * The request failed.
+   */
+  400: ProblemDetails;
+  /**
+   * The request failed.
+   */
+  401: ProblemDetails;
+  /**
+   * The request failed.
+   */
+  403: ProblemDetails;
+  /**
+   * The request failed.
+   */
+  429: ProblemDetails;
+  /**
+   * The request failed.
+   */
+  503: ProblemDetails;
+};
+
+export type GetProjectHandleAvailabilityError =
+  GetProjectHandleAvailabilityErrors[keyof GetProjectHandleAvailabilityErrors];
+
+export type GetProjectHandleAvailabilityResponses = {
+  /**
+   * Whether the handle is usable, and alternatives when it is not.
+   */
+  200: ProjectHandleAvailability;
+};
+
+export type GetProjectHandleAvailabilityResponse =
+  GetProjectHandleAvailabilityResponses[keyof GetProjectHandleAvailabilityResponses];
+
 export type CreateProjectDevAccessTicketData = {
   body?: never;
   headers?: {