needle-cloud 2.10.0 → 2.11.0

package/dist/cli.esm.js

@@ -1 +1 @@
-import"node-fetch";import"@web-std/file";import"node:crypto";export{p as program}from"./cli-ff9cbc77.js";import"fs";import"dotenv";import"ora";import"commander";import"child_process";import"open";import"path";import"node:fs";import"node:fs/promises";import"node:os";import"node:path";import"util";import"stream";import"http";import"https";import"url";import"crypto";import"net";import"tls";import"assert";import"tty";import"os";import"events";import"http2";import"zlib";import"node:console";import"node:readline/promises";import"@logto/node";import"node:readline";import"node:stream";import"node:zlib";import"express";import"ws";import"node:child_process";import"minimatch";import"node:url";import"node:util";import"body-parser";import"node:timers/promises";
+import"node-fetch";import"@web-std/file";import"node:crypto";export{p as program}from"./cli-05c1463b.js";import"fs";import"dotenv";import"ora";import"commander";import"child_process";import"open";import"path";import"node:fs";import"node:fs/promises";import"node:os";import"node:path";import"util";import"stream";import"http";import"https";import"url";import"crypto";import"net";import"tls";import"assert";import"tty";import"os";import"events";import"http2";import"zlib";import"node:console";import"node:readline/promises";import"@logto/node";import"node:readline";import"node:stream";import"node:zlib";import"express";import"ws";import"node:child_process";import"minimatch";import"node:url";import"node:util";import"body-parser";import"node:timers/promises";

package/dist/{cli.send-logs.discovery-4b1990b5.js → cli.send-logs.discovery-11259aaf.js}

@@ -1 +1 @@
-import{existsSync as o,readdirSync as t,statSync as r}from"node:fs";import{dirname as i,join as e}from"node:path";import{g as n}from"./cli-ff9cbc77.js";import"node-fetch";import"@web-std/file";import"node:crypto";import"commander";import"fs";import"child_process";import"open";import"path";import"ora";import"node:fs/promises";import"node:os";import"util";import"stream";import"http";import"https";import"url";import"crypto";import"net";import"tls";import"assert";import"tty";import"os";import"events";import"http2";import"zlib";import"node:console";import"node:readline/promises";import"dotenv";import"@logto/node";import"node:readline";import"node:stream";import"node:zlib";import"express";import"ws";import"node:child_process";import"minimatch";import"node:url";import"node:util";import"body-parser";import"node:timers/promises";function p(){var p;let m;try{m=n()}catch{return null}const s=null==(p=m)||null==(p=p.entries)?void 0:p[0];if(!s)return null;if(!s.log_location)return null;if("unity"!==s.editor&&"blender"!==s.editor)return null;if(!o(s.log_location))return null;const l=s.log_location,d=function(o,i){const n=new Set([i]);try{for(const i of t(o)){if(!i.toLowerCase().endsWith(".log"))continue;const t=e(o,i);try{if(!r(t).isFile())continue}catch{continue}n.add(t)}}catch{}return[...n]}(i(l),l);return{editor:s.editor,path:l,paths:d}}export{p as findActiveEditorLog};
+import{existsSync as o,readdirSync as t,statSync as r}from"node:fs";import{dirname as i,join as e}from"node:path";import{g as n}from"./cli-05c1463b.js";import"node-fetch";import"@web-std/file";import"node:crypto";import"commander";import"fs";import"child_process";import"open";import"path";import"ora";import"node:fs/promises";import"node:os";import"util";import"stream";import"http";import"https";import"url";import"crypto";import"net";import"tls";import"assert";import"tty";import"os";import"events";import"http2";import"zlib";import"node:console";import"node:readline/promises";import"dotenv";import"@logto/node";import"node:readline";import"node:stream";import"node:zlib";import"express";import"ws";import"node:child_process";import"minimatch";import"node:url";import"node:util";import"body-parser";import"node:timers/promises";function p(){var p;let m;try{m=n()}catch{return null}const s=null==(p=m)||null==(p=p.entries)?void 0:p[0];if(!s)return null;if(!s.log_location)return null;if("unity"!==s.editor&&"blender"!==s.editor)return null;if(!o(s.log_location))return null;const l=s.log_location,d=function(o,i){const n=new Set([i]);try{for(const i of t(o)){if(!i.toLowerCase().endsWith(".log"))continue;const t=e(o,i);try{if(!r(t).isFile())continue}catch{continue}n.add(t)}}catch{}return[...n]}(i(l),l);return{editor:s.editor,path:l,paths:d}}export{p as findActiveEditorLog};

package/dist/index.d.ts

@@ -715,6 +715,163 @@ type ChatSessionSendOptions$1 = {
     context?: ClientContext[],
 }
 
+/**
+ * @internal Needle editor cloud projects — versioned revisions of OPAQUE
+ * project documents (needle-cloud plans/cloud-projects-api.md). Editor-only,
+ * NO stability guarantee, deliberately not in the public OpenAPI docs.
+ *
+ * The server never parses a document: it stores blobs plus a revision graph.
+ * These types ARE the wire contract the editor's IProjectRemote adapter
+ * aligns to.
+ */
+
+/** derived server-side from timestamps; deleted outranks archived.
+ * "deleted" lists the BIN (bounded to the restore window). */
+type ProjectState = "active" | "archived" | "deleted";
+
+interface ProjectInfo {
+    /** public project handle (projects.identifier) */
+    id: string;
+    name: string;
+    /** product discriminator, e.g. "web-project" (the editor) — opaque to the server */
+    kind?: string;
+    created_at?: string | null;
+    updated_at?: string | null;
+    /** set = the project is ARCHIVED (read-only; pushes return 409) */
+    archived_at?: string | null;
+    /** set = the project is in the BIN (only on ?state=deleted listings) */
+    deleted_at?: string | null;
+    /** user-editable metadata — opaque to the server */
+    description?: string | null;
+    tags?: string[] | null;
+    /** newest revision's actor id — null for a project with no pushes */
+    updated_by?: string | null;
+    /** resolved display name of updated_by (cached lookup) — null when unresolvable */
+    updated_by_name?: string | null;
+}
+
+interface ProjectRevisionInfo {
+    /** resolved display name of the actor (server-side cached Logto lookup);
+     * null when unresolvable — the actor ID stays the stored truth.
+     * Present on the revisions LISTING only. */
+    actorName?: string | null;
+    /** 1-based, strictly increasing per project */
+    revision: number;
+    /** the revision this push was built on (0 for the first) */
+    baseRevision: number;
+    /** sha-256 hex of the full document bytes */
+    hash: string;
+    /** token identity of the pusher — never client-supplied */
+    actor: string;
+    /** ISO timestamp */
+    timestamp: string | null;
+    /** hash of the revision's `.needle/thumbnail.jpg` manifest entry — fetch
+     * via blobs/download for a per-revision preview; null when the revision
+     * carried no thumbnail */
+    thumbnail?: string | null;
+    /** byte length of the document blob — revisions LISTING only (null when
+     * the blob is unexpectedly absent) */
+    size?: number | null;
+    /** total bytes of the folder files riding this revision (manifest sum;
+     * blobs are shared/deduped — footprint, not storage cost) */
+    filesSize?: number | null;
+    /** short human handle ("client-review") — user-editable via revisions/update */
+    label?: string | null;
+    /** what changed in this revision — user-written (a generated default may
+     * fill it later; user text wins by being set) */
+    description?: string | null;
+}
+
+/** PARTIAL revision metadata update: absent = keep, null = clear */
+interface UpdateProjectRevisionRequest {
+    /** project id (public handle) */
+    project: string;
+    revision: number;
+    /** 1-64 characters, or null to clear */
+    label?: string | null;
+    /** max 4000 characters, or null to clear */
+    description?: string | null;
+}
+
+interface CreateProjectResponse {
+    id: string;
+    name: string;
+    kind?: string;
+}
+
+interface ListProjectsResponse {
+    projects: ProjectInfo[];
+}
+
+/** PARTIAL update: absent = keep, null = clear */
+interface UpdateProjectRequest {
+    name?: string;
+    description?: string | null;
+    /** max 20 tags, 1-64 characters each (deduped server-side) */
+    tags?: string[] | null;
+}
+
+interface UpdateProjectResponse {
+    id: string;
+    name: string;
+    description: string | null;
+    tags: string[] | null;
+}
+
+interface CloneProjectResponse {
+    /** the COPY's public handle */
+    id: string;
+    name: string;
+    kind?: string;
+    /** the source project's handle */
+    sourceId: string;
+}
+
+interface ProjectHeadResponse {
+    head: ProjectRevisionInfo | null;
+}
+
+interface PushProjectRequest {
+    /** project id (public handle) */
+    project: string;
+    /** optimistic-concurrency token: the revision the client built on */
+    baseRevision: number;
+    /** sha-256 hex of the decoded bytes — verified server-side */
+    hash: string;
+    /** base64 document bytes */
+    bytes: string;
+}
+
+interface PushProjectResponse {
+    /** ok = revision minted; unchanged = identical to head, nothing minted;
+     *  stale = head moved past the base — pull, merge client-side, retry */
+    status: "ok" | "unchanged" | "stale";
+    head: ProjectRevisionInfo;
+}
+
+interface PullProjectResponse {
+    info: ProjectRevisionInfo;
+    /** base64 document bytes */
+    bytes: string;
+}
+
+/** Deployment attempts are returned newest first. URLs identify exact deployed versions. */
+interface ProjectDeploymentsResponse {
+    contentId: string | null;
+    url: string | null;
+    attempts: Array<{
+        revision: number | null;
+        contentId: string;
+        jobId: string;
+        /** ISO timestamp, or null when unavailable for an older attempt. */
+        createdAt: string | null;
+        actor: string;
+        status: JobStatus | null;
+        error: string | null;
+        url: string | null;
+    }>;
+}
+
 // #region Tone mapping
 
 /**
@@ -918,8 +1075,17 @@ type ContentFormat = typeof CONTENT_FORMATS[number];
 // change. Public is intentionally a slimmer subset (no internal IDs, no per-file
 // enumeration).
 
-/** Response for GET /v1/content/:identifier */
+/** A library item can be uploaded content or a saved web project. */
+type ContentItemType = "content" | "editor-project";
+type ContentListType = ContentType | "editor-project";
+
+/** Select an item namespace when an upload and a project share an identifier. */
+type GetContentRequestQuery = { item?: ContentItemType };
+
+/** Response for an uploaded item from GET /v1/content/:identifier */
 type GetContentDetailResponse = {
+    /** Uploaded content; omitted by older servers. */
+    item_type?: "content",
     /** Unique content identifier */
     identifier: string,
     /** ISO 8601 timestamp */
@@ -1095,6 +1261,16 @@ type ContentProcessingState =
         progress?: undefined,
         error?: undefined,
     }
+
+/** Response from GET /v1/content/:identifier — alias for GetContentDetailResponse */
+/** Saved project detail. Revisions describe saved documents, not upload jobs. */
+type GetProjectContentDetailResponse = Omit<GetContentDetailResponse, "item_type" | "content_type" | "versions"> & {
+    item_type: "editor-project";
+    content_type: "editor-project";
+    versions: [];
+    editorProject: { info: ProjectInfo; revisions: ProjectRevisionInfo[]; deployments: ProjectDeploymentsResponse };
+};
+type GetContentResponse = GetContentDetailResponse | GetProjectContentDetailResponse;
 // #endregion
 
 
@@ -1103,7 +1279,9 @@ type ContentProcessingState =
 /** Query parameters for GET /v1/content */
 type ListContentRequestQuery = {
     /** Filter by content type (e.g. "material", "3d-asset") */
-    content_type?: ContentType;
+    content_type?: ContentListType;
+    /** Include saved web projects alongside uploaded content (default false). */
+    include_projects?: boolean;
     /** Filter by output content format (e.g. "glb", "textures"). When set, only
      *  items with a matching output are returned, and artifact data comes from
      *  that output. Matches against `content_format` on job_outputs. */
@@ -1132,6 +1310,10 @@ type ListContentRequestQuery = {
  * A single item in the GET /v1/content list response.
  */
 type ContentListItem = {
+    /** Distinguishes saved projects from uploaded content. */
+    item_type?: ContentItemType;
+    /** Saved project metadata, present only for editor-project items. */
+    editorProject?: ProjectInfo;
     identifier: string;
     title: string | null;
     description: string | null;
@@ -1145,7 +1327,7 @@ type ContentListItem = {
      *  upload's URL. Null when no completed job/output is available. */
     url: string | null;
     /** Semantic content type derived from job_outputs (e.g. "3d-asset", "material") */
-    content_type: ContentType | null;
+    content_type: ContentListType | null;
     /** Available content formats for this content item (e.g. ["glb", "textures"]) */
     content_formats: ContentFormat[];
     /** Page for editing this item in the cloud UI. Present for everything the
@@ -1155,7 +1337,7 @@ type ContentListItem = {
     /** Standalone viewer page. Null for deployments (they ARE a website — use
      *  `url`) and for items with no artifact to view yet. */
     view_url?: string | null;
-    /** Number of top-level versions (matches the versions[] array in the detail response) */
+    /** Number of upload versions, or the latest saved project revision number. */
     version_count: number;
     /** Whether the content is password-protected (requires commercial license) */
     password_protected: boolean;
@@ -2010,8 +2192,8 @@ declare function listContent(opts?: {
  * See {@link listContent} for auth behavior.
  *
  * @param {string} identifier
- * @param {{ org?: string, authToken?: string }} [opts]
- * @returns {Promise<import("@needle-tools/cloud-sdk/types/api.content").GetContentDetailResponse>}
+ * @param {{ org?: string, authToken?: string } & import("@needle-tools/cloud-sdk/types/api.content").GetContentRequestQuery} [opts]
+ * @returns {Promise<import("@needle-tools/cloud-sdk/types/api.content").GetContentResponse>}
  *
  * @example
  *   import { getContent } from "needle-cloud";
@@ -2021,7 +2203,7 @@ declare function listContent(opts?: {
 declare function getContent(identifier: string, opts?: {
     org?: string;
     authToken?: string;
-}): Promise<GetContentDetailResponse>;
+} & GetContentRequestQuery): Promise<GetContentResponse>;
 /**
  * Update a content item's metadata, and optionally set its thumbnail.
  *
@@ -2118,162 +2300,6 @@ declare function generate3dAsset(opts: Ai3dAssetRequestParameters & Generate3dAs
     filename?: string;
 }>;
 
-/**
- * @internal Needle editor cloud projects — versioned revisions of OPAQUE
- * project documents (needle-cloud plans/cloud-projects-api.md). Editor-only,
- * NO stability guarantee, deliberately not in the public OpenAPI docs.
- *
- * The server never parses a document: it stores blobs plus a revision graph.
- * These types ARE the wire contract the editor's IProjectRemote adapter
- * aligns to.
- */
-
-/** derived server-side from timestamps; deleted outranks archived.
- * "deleted" lists the BIN (bounded to the restore window). */
-type ProjectState = "active" | "archived" | "deleted";
-
-interface ProjectInfo {
-    /** public project handle (projects.identifier) */
-    id: string;
-    name: string;
-    /** product discriminator, e.g. "web-project" (the editor) — opaque to the server */
-    kind?: string;
-    created_at?: string | null;
-    updated_at?: string | null;
-    /** set = the project is ARCHIVED (read-only; pushes return 409) */
-    archived_at?: string | null;
-    /** set = the project is in the BIN (only on ?state=deleted listings) */
-    deleted_at?: string | null;
-    /** user-editable metadata — opaque to the server */
-    description?: string | null;
-    tags?: string[] | null;
-    /** newest revision's actor id — null for a project with no pushes */
-    updated_by?: string | null;
-    /** resolved display name of updated_by (cached lookup) — null when unresolvable */
-    updated_by_name?: string | null;
-}
-
-interface ProjectRevisionInfo {
-    /** resolved display name of the actor (server-side cached Logto lookup);
-     * null when unresolvable — the actor ID stays the stored truth.
-     * Present on the revisions LISTING only. */
-    actorName?: string | null;
-    /** 1-based, strictly increasing per project */
-    revision: number;
-    /** the revision this push was built on (0 for the first) */
-    baseRevision: number;
-    /** sha-256 hex of the full document bytes */
-    hash: string;
-    /** token identity of the pusher — never client-supplied */
-    actor: string;
-    /** ISO timestamp */
-    timestamp: string | null;
-    /** hash of the revision's `.needle/thumbnail.jpg` manifest entry — fetch
-     * via blobs/download for a per-revision preview; null when the revision
-     * carried no thumbnail */
-    thumbnail?: string | null;
-    /** byte length of the document blob — revisions LISTING only (null when
-     * the blob is unexpectedly absent) */
-    size?: number | null;
-    /** total bytes of the folder files riding this revision (manifest sum;
-     * blobs are shared/deduped — footprint, not storage cost) */
-    filesSize?: number | null;
-    /** short human handle ("client-review") — user-editable via revisions/update */
-    label?: string | null;
-    /** what changed in this revision — user-written (a generated default may
-     * fill it later; user text wins by being set) */
-    description?: string | null;
-}
-
-/** PARTIAL revision metadata update: absent = keep, null = clear */
-interface UpdateProjectRevisionRequest {
-    /** project id (public handle) */
-    project: string;
-    revision: number;
-    /** 1-64 characters, or null to clear */
-    label?: string | null;
-    /** max 4000 characters, or null to clear */
-    description?: string | null;
-}
-
-interface CreateProjectResponse {
-    id: string;
-    name: string;
-    kind?: string;
-}
-
-interface ListProjectsResponse {
-    projects: ProjectInfo[];
-}
-
-/** PARTIAL update: absent = keep, null = clear */
-interface UpdateProjectRequest {
-    name?: string;
-    description?: string | null;
-    /** max 20 tags, 1-64 characters each (deduped server-side) */
-    tags?: string[] | null;
-}
-
-interface UpdateProjectResponse {
-    id: string;
-    name: string;
-    description: string | null;
-    tags: string[] | null;
-}
-
-interface CloneProjectResponse {
-    /** the COPY's public handle */
-    id: string;
-    name: string;
-    kind?: string;
-    /** the source project's handle */
-    sourceId: string;
-}
-
-interface ProjectHeadResponse {
-    head: ProjectRevisionInfo | null;
-}
-
-interface PushProjectRequest {
-    /** project id (public handle) */
-    project: string;
-    /** optimistic-concurrency token: the revision the client built on */
-    baseRevision: number;
-    /** sha-256 hex of the decoded bytes — verified server-side */
-    hash: string;
-    /** base64 document bytes */
-    bytes: string;
-}
-
-interface PushProjectResponse {
-    /** ok = revision minted; unchanged = identical to head, nothing minted;
-     *  stale = head moved past the base — pull, merge client-side, retry */
-    status: "ok" | "unchanged" | "stale";
-    head: ProjectRevisionInfo;
-}
-
-interface PullProjectResponse {
-    info: ProjectRevisionInfo;
-    /** base64 document bytes */
-    bytes: string;
-}
-
-/** Deployment attempts are returned newest first. URLs identify exact deployed versions. */
-interface ProjectDeploymentsResponse {
-    contentId: string | null;
-    url: string | null;
-    attempts: Array<{
-        revision: number | null;
-        contentId: string;
-        jobId: string;
-        createdAt: string;
-        actor: string;
-        status: JobStatus | null;
-        error: string | null;
-        url: string | null;
-    }>;
-}
-
 /**
  * @internal Needle editor cloud projects — versioned revisions of OPAQUE
  * project documents. Editor-only, NO stability guarantee (needle-cloud