@onexapis/cli 1.1.44 → 1.1.45

package/dist/index.d.mts

@@ -38,6 +38,25 @@ interface BuildOptions {
 }
 declare function buildCommand(options: BuildOptions): Promise<void>;
 
+/**
+ * `onexthm upload` is deprecated.
+ *
+ * It used to push bundle.zip / source.zip / latest.json directly to S3 via
+ * the AWS SDK. The platform no longer exposes themes via direct S3 access,
+ * so this path is broken by construction. The canonical replacement is
+ * `onexthm publish`, which:
+ *
+ *   1. Authenticates against the platform (`onexthm login`)
+ *   2. Registers the theme + version through the API
+ *   3. Receives presigned PUT URLs for bundle.zip, source.zip, and any
+ *      content-hashed assets
+ *   4. Uploads everything via HTTP and confirms the publish
+ *
+ * This file is kept (rather than deleted) so existing CI scripts that call
+ * `onexthm upload` get a clear migration message instead of "command not
+ * found". After all consumers migrate, the command can be removed from
+ * cli.ts entirely.
+ */
 interface UploadOptions {
     theme?: string;
     bucket?: string;
@@ -47,42 +66,47 @@ interface UploadOptions {
     skipSource?: boolean;
     sourceDir?: string;
 }
-/**
- * Upload theme to S3 as zip files
- *
- * Creates bundle.zip (compiled output) and source.zip (theme source code),
- * then uploads both to S3. Much faster than uploading 100+ individual files.
- */
-declare function uploadCommand(options: UploadOptions): Promise<void>;
+declare function uploadCommand(_options: UploadOptions): Promise<void>;
 
 interface DownloadOptions {
     themeId?: string;
     version?: string;
+    output?: string;
+    /** @deprecated kept for backwards-compat with older scripts; ignored. */
     bucket?: string;
+    /** @deprecated kept for backwards-compat with older scripts; ignored. */
     environment?: "staging" | "production";
-    output?: string;
 }
 /**
- * Download theme from S3
+ * Download a published theme via the website-api Lambda endpoints.
  *
- * Downloads bundle.zip (single S3 request) and extracts all files locally.
- * Much faster than downloading 100+ individual files.
+ * This command no longer talks to S3 directly — the platform now serves
+ * theme content through HTTP-only endpoints, so AWS credentials, bucket
+ * names, and region settings are no longer required. The legacy
+ * `--bucket` and `--environment` flags are accepted but ignored for
+ * backwards compatibility with existing scripts.
  */
 declare function downloadCommand(options: DownloadOptions): Promise<void>;
 
 interface CloneOptions {
     version?: string;
     output?: string;
+    /** @deprecated kept for backwards-compat with older scripts; ignored. */
     bucket?: string;
+    /** @deprecated kept for backwards-compat with older scripts; ignored. */
     environment?: "staging" | "production";
     install?: boolean;
     name?: string;
 }
 /**
- * Clone theme source code from S3
+ * Clone theme source code via the website-api.
+ *
+ * Calls the authenticated `/source` Lambda to get a presigned S3 URL,
+ * downloads the source.zip, and extracts it to a local directory. Asks
+ * the user for a new theme name to differentiate from the original.
  *
- * Downloads source.zip and extracts it to a local directory.
- * Asks the user for a new theme name to differentiate from the original.
+ * Requires login (`onexthm login`) — the source endpoint is JWT-gated
+ * because cloning grants access to a developer's full theme source.
  */
 declare function cloneCommand(themeName: string, options: CloneOptions): Promise<void>;
 

package/dist/index.d.ts

@@ -38,6 +38,25 @@ interface BuildOptions {
 }
 declare function buildCommand(options: BuildOptions): Promise<void>;
 
+/**
+ * `onexthm upload` is deprecated.
+ *
+ * It used to push bundle.zip / source.zip / latest.json directly to S3 via
+ * the AWS SDK. The platform no longer exposes themes via direct S3 access,
+ * so this path is broken by construction. The canonical replacement is
+ * `onexthm publish`, which:
+ *
+ *   1. Authenticates against the platform (`onexthm login`)
+ *   2. Registers the theme + version through the API
+ *   3. Receives presigned PUT URLs for bundle.zip, source.zip, and any
+ *      content-hashed assets
+ *   4. Uploads everything via HTTP and confirms the publish
+ *
+ * This file is kept (rather than deleted) so existing CI scripts that call
+ * `onexthm upload` get a clear migration message instead of "command not
+ * found". After all consumers migrate, the command can be removed from
+ * cli.ts entirely.
+ */
 interface UploadOptions {
     theme?: string;
     bucket?: string;
@@ -47,42 +66,47 @@ interface UploadOptions {
     skipSource?: boolean;
     sourceDir?: string;
 }
-/**
- * Upload theme to S3 as zip files
- *
- * Creates bundle.zip (compiled output) and source.zip (theme source code),
- * then uploads both to S3. Much faster than uploading 100+ individual files.
- */
-declare function uploadCommand(options: UploadOptions): Promise<void>;
+declare function uploadCommand(_options: UploadOptions): Promise<void>;
 
 interface DownloadOptions {
     themeId?: string;
     version?: string;
+    output?: string;
+    /** @deprecated kept for backwards-compat with older scripts; ignored. */
     bucket?: string;
+    /** @deprecated kept for backwards-compat with older scripts; ignored. */
     environment?: "staging" | "production";
-    output?: string;
 }
 /**
- * Download theme from S3
+ * Download a published theme via the website-api Lambda endpoints.
  *
- * Downloads bundle.zip (single S3 request) and extracts all files locally.
- * Much faster than downloading 100+ individual files.
+ * This command no longer talks to S3 directly — the platform now serves
+ * theme content through HTTP-only endpoints, so AWS credentials, bucket
+ * names, and region settings are no longer required. The legacy
+ * `--bucket` and `--environment` flags are accepted but ignored for
+ * backwards compatibility with existing scripts.
  */
 declare function downloadCommand(options: DownloadOptions): Promise<void>;
 
 interface CloneOptions {
     version?: string;
     output?: string;
+    /** @deprecated kept for backwards-compat with older scripts; ignored. */
     bucket?: string;
+    /** @deprecated kept for backwards-compat with older scripts; ignored. */
     environment?: "staging" | "production";
     install?: boolean;
     name?: string;
 }
 /**
- * Clone theme source code from S3
+ * Clone theme source code via the website-api.
+ *
+ * Calls the authenticated `/source` Lambda to get a presigned S3 URL,
+ * downloads the source.zip, and extracts it to a local directory. Asks
+ * the user for a new theme name to differentiate from the original.
  *
- * Downloads source.zip and extracts it to a local directory.
- * Asks the user for a new theme name to differentiate from the original.
+ * Requires login (`onexthm login`) — the source endpoint is JWT-gated
+ * because cloning grants access to a developer's full theme source.
  */
 declare function cloneCommand(themeName: string, options: CloneOptions): Promise<void>;