@valtown/sdk 0.29.1 → 0.31.0

package/resources/projects/files.mjs

@@ -1,7 +1,14 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 import { APIResource } from "../../resource.mjs";
+import { isRequestOptions } from "../../core.mjs";
 import { PageCursorURL } from "../../pagination.mjs";
 export class Files extends APIResource {
+    /**
+     * Get metadata for files and directories in a project at the specified path
+     */
+    retrieve(projectId, path, query, options) {
+        return this._client.get(`/v1/projects/${projectId}/files/${path}`, { query, ...options });
+    }
     /**
      * Get metadata for files and directories in a project at the root directory
      */
@@ -11,6 +18,24 @@ export class Files extends APIResource {
             ...options,
         });
     }
+    content(projectId, path, params = {}, options) {
+        if (isRequestOptions(params)) {
+            return this.content(projectId, path, {}, params);
+        }
+        const { 'Cache-Control': cacheControl, 'If-Match': ifMatch, 'If-Modified-Since': ifModifiedSince, 'If-None-Match': ifNoneMatch, 'If-Unmodified-Since': ifUnmodifiedSince, ...query } = params;
+        return this._client.get(`/v1/projects/${projectId}/files/${path}/content`, {
+            query,
+            ...options,
+            headers: {
+                ...(cacheControl != null ? { 'Cache-Control': cacheControl } : undefined),
+                ...(ifMatch != null ? { 'If-Match': ifMatch } : undefined),
+                ...(ifModifiedSince != null ? { 'If-Modified-Since': ifModifiedSince } : undefined),
+                ...(ifNoneMatch != null ? { 'If-None-Match': ifNoneMatch } : undefined),
+                ...(ifUnmodifiedSince != null ? { 'If-Unmodified-Since': ifUnmodifiedSince } : undefined),
+                ...options?.headers,
+            },
+        });
+    }
 }
 export class FileListResponsesPageCursorURL extends PageCursorURL {
 }

package/resources/projects/files.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"files.mjs","sourceRoot":"","sources":["../../src/resources/projects/files.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,EAAE,aAAa,EAA4B;AAElD,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC;;OAEG;IACH,IAAI,CACF,SAAiB,EACjB,KAAqB,EACrB,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,gBAAgB,SAAS,QAAQ,EAAE,8BAA8B,EAAE;YAChG,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;CACF;AAED,MAAM,OAAO,8BAA+B,SAAQ,aAA+B;CAAG;AAqDtF,KAAK,CAAC,8BAA8B,GAAG,8BAA8B,CAAC"}
+{"version":3,"file":"files.mjs","sourceRoot":"","sources":["../../src/resources/projects/files.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,EAAE,gBAAgB,EAAE;OAGpB,EAAE,aAAa,EAA4B;AAElD,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC;;OAEG;IACH,QAAQ,CACN,SAAiB,EACjB,IAAY,EACZ,KAAyB,EACzB,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,SAAS,UAAU,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED;;OAEG;IACH,IAAI,CACF,SAAiB,EACjB,KAAqB,EACrB,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,gBAAgB,SAAS,QAAQ,EAAE,8BAA8B,EAAE;YAChG,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAYD,OAAO,CACL,SAAiB,EACjB,IAAY,EACZ,SAAkD,EAAE,EACpD,OAA6B;QAE7B,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE;YAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;SAClD;QACD,MAAM,EACJ,eAAe,EAAE,YAAY,EAC7B,UAAU,EAAE,OAAO,EACnB,mBAAmB,EAAE,eAAe,EACpC,eAAe,EAAE,WAAW,EAC5B,qBAAqB,EAAE,iBAAiB,EACxC,GAAG,KAAK,EACT,GAAG,MAAM,CAAC;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,SAAS,UAAU,IAAI,UAAU,EAAE;YACzE,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE;gBACP,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBACzE,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC1D,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBACnF,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBACvE,GAAG,CAAC,iBAAiB,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBACzF,GAAG,OAAO,EAAE,OAAO;aACpB;SACF,CAAC,CAAC;IACL,CAAC;CACF;AAED,MAAM,OAAO,8BAA+B,SAAQ,aAA+B;CAAG;AA0LtF,KAAK,CAAC,8BAA8B,GAAG,8BAA8B,CAAC"}

package/resources/projects/index.d.ts

@@ -1,4 +1,4 @@
 export { BranchListResponsesPageCursorURL, Branches, type BranchRetrieveResponse, type BranchListResponse, type BranchListParams, } from "./branches.js";
-export { FileListResponsesPageCursorURL, Files, type FileListResponse, type FileListParams } from "./files.js";
+export { FileListResponsesPageCursorURL, Files, type FileRetrieveResponse, type FileListResponse, type FileContentResponse, type FileRetrieveParams, type FileListParams, type FileContentParams, } from "./files.js";
 export { ProjectListResponsesPageCursorURL, Projects, type ProjectRetrieveResponse, type ProjectListResponse, type ProjectListParams, } from "./projects.js";
 //# sourceMappingURL=index.d.ts.map

package/resources/projects/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/projects/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,gCAAgC,EAChC,QAAQ,EACR,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,8BAA8B,EAAE,KAAK,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAC5G,OAAO,EACL,iCAAiC,EACjC,QAAQ,EACR,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/projects/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,gCAAgC,EAChC,QAAQ,EACR,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,8BAA8B,EAC9B,KAAK,EACL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,iBAAiB,GACvB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,iCAAiC,EACjC,QAAQ,EACR,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC"}

package/resources/projects/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/projects/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,0CAMoB;AALlB,4HAAA,gCAAgC,OAAA;AAChC,oGAAA,QAAQ,OAAA;AAKV,oCAA4G;AAAnG,uHAAA,8BAA8B,OAAA;AAAE,8FAAA,KAAK,OAAA;AAC9C,0CAMoB;AALlB,6HAAA,iCAAiC,OAAA;AACjC,oGAAA,QAAQ,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/projects/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,0CAMoB;AALlB,4HAAA,gCAAgC,OAAA;AAChC,oGAAA,QAAQ,OAAA;AAKV,oCASiB;AARf,uHAAA,8BAA8B,OAAA;AAC9B,8FAAA,KAAK,OAAA;AAQP,0CAMoB;AALlB,6HAAA,iCAAiC,OAAA;AACjC,oGAAA,QAAQ,OAAA"}

package/resources/projects/index.mjs

@@ -1,5 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 export { BranchListResponsesPageCursorURL, Branches, } from "./branches.mjs";
-export { FileListResponsesPageCursorURL, Files } from "./files.mjs";
+export { FileListResponsesPageCursorURL, Files, } from "./files.mjs";
 export { ProjectListResponsesPageCursorURL, Projects, } from "./projects.mjs";
 //# sourceMappingURL=index.mjs.map

package/resources/projects/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/projects/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EACL,gCAAgC,EAChC,QAAQ,GAIT;OACM,EAAE,8BAA8B,EAAE,KAAK,EAA8C;OACrF,EACL,iCAAiC,EACjC,QAAQ,GAIT"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/projects/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EACL,gCAAgC,EAChC,QAAQ,GAIT;OACM,EACL,8BAA8B,EAC9B,KAAK,GAON;OACM,EACL,iCAAiC,EACjC,QAAQ,GAIT"}

package/resources/projects/projects.d.ts

@@ -3,7 +3,7 @@ import * as Core from "../../core.js";
 import * as BranchesAPI from "./branches.js";
 import { BranchListParams, BranchListResponse, BranchListResponsesPageCursorURL, BranchRetrieveResponse, Branches } from "./branches.js";
 import * as FilesAPI from "./files.js";
-import { FileListParams, FileListResponse, FileListResponsesPageCursorURL, Files } from "./files.js";
+import { FileContentParams, FileContentResponse, FileListParams, FileListResponse, FileListResponsesPageCursorURL, FileRetrieveParams, FileRetrieveResponse, Files } from "./files.js";
 import { PageCursorURL, type PageCursorURLParams } from "../../pagination.js";
 /**
  * Projects let you organize multiple files and collaborate with pull requests
@@ -37,22 +37,29 @@ export interface ProjectRetrieveResponse {
      * The URL of this project's image
      */
     imageUrl: string | null;
+    links: ProjectRetrieveResponse.Links;
     name: string;
     /**
      * This resource's privacy setting. Unlisted resources do not appear on profile
      * pages or elsewhere, but you can link to them.
      */
     privacy: 'public' | 'unlisted' | 'private';
-    /**
-     * The URL of this resource on the Val Town website
-     */
-    valTownUrl: string;
 }
 export declare namespace ProjectRetrieveResponse {
     interface Author {
         id: string;
         username: string | null;
     }
+    interface Links {
+        /**
+         * The URL of this resource on Val Town
+         */
+        html: string;
+        /**
+         * The URL of this resource on this API
+         */
+        self: string;
+    }
 }
 /**
  * A Project
@@ -69,28 +76,35 @@ export interface ProjectListResponse {
      * The URL of this project's image
      */
     imageUrl: string | null;
+    links: ProjectListResponse.Links;
     name: string;
     /**
      * This resource's privacy setting. Unlisted resources do not appear on profile
      * pages or elsewhere, but you can link to them.
      */
     privacy: 'public' | 'unlisted' | 'private';
-    /**
-     * The URL of this resource on the Val Town website
-     */
-    valTownUrl: string;
 }
 export declare namespace ProjectListResponse {
     interface Author {
         id: string;
         username: string | null;
     }
+    interface Links {
+        /**
+         * The URL of this resource on Val Town
+         */
+        html: string;
+        /**
+         * The URL of this resource on this API
+         */
+        self: string;
+    }
 }
 export interface ProjectListParams extends PageCursorURLParams {
 }
 export declare namespace Projects {
     export { type ProjectRetrieveResponse as ProjectRetrieveResponse, type ProjectListResponse as ProjectListResponse, ProjectListResponsesPageCursorURL as ProjectListResponsesPageCursorURL, type ProjectListParams as ProjectListParams, };
     export { Branches as Branches, type BranchRetrieveResponse as BranchRetrieveResponse, type BranchListResponse as BranchListResponse, BranchListResponsesPageCursorURL as BranchListResponsesPageCursorURL, type BranchListParams as BranchListParams, };
-    export { Files as Files, type FileListResponse as FileListResponse, FileListResponsesPageCursorURL as FileListResponsesPageCursorURL, type FileListParams as FileListParams, };
+    export { Files as Files, type FileRetrieveResponse as FileRetrieveResponse, type FileListResponse as FileListResponse, type FileContentResponse as FileContentResponse, FileListResponsesPageCursorURL as FileListResponsesPageCursorURL, type FileRetrieveParams as FileRetrieveParams, type FileListParams as FileListParams, type FileContentParams as FileContentParams, };
 }
 //# sourceMappingURL=projects.d.ts.map

package/resources/projects/projects.d.ts.map

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

package/resources/projects/projects.js.map

@@ -1 +1 @@
-{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/resources/projects/projects.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;;;;;;;;;;;;;;;;;;;;;;;AAEtF,gDAA6C;AAE7C,2DAA0C;AAC1C,4CAMoB;AACpB,qDAAoC;AACpC,sCAAkG;AAClG,oDAA2E;AAE3E;;GAEG;AACH,MAAa,QAAS,SAAQ,sBAAW;IAAzC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAkB3D,CAAC;IAhBC;;OAEG;IACH,QAAQ,CAAC,SAAiB,EAAE,OAA6B;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED;;OAEG;IACH,IAAI,CACF,KAAwB,EACxB,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,iCAAiC,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3G,CAAC;CACF;AApBD,4BAoBC;AAED,MAAa,iCAAkC,SAAQ,0BAAkC;CAAG;AAA5F,8EAA4F;AAwF5F,QAAQ,CAAC,iCAAiC,GAAG,iCAAiC,CAAC;AAC/E,QAAQ,CAAC,QAAQ,GAAG,mBAAQ,CAAC;AAC7B,QAAQ,CAAC,gCAAgC,GAAG,2CAAgC,CAAC;AAC7E,QAAQ,CAAC,KAAK,GAAG,aAAK,CAAC;AACvB,QAAQ,CAAC,8BAA8B,GAAG,sCAA8B,CAAC"}
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/resources/projects/projects.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;;;;;;;;;;;;;;;;;;;;;;;AAEtF,gDAA6C;AAE7C,2DAA0C;AAC1C,4CAMoB;AACpB,qDAAoC;AACpC,sCASiB;AACjB,oDAA2E;AAE3E;;GAEG;AACH,MAAa,QAAS,SAAQ,sBAAW;IAAzC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAkB3D,CAAC;IAhBC;;OAEG;IACH,QAAQ,CAAC,SAAiB,EAAE,OAA6B;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED;;OAEG;IACH,IAAI,CACF,KAAwB,EACxB,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,iCAAiC,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3G,CAAC;CACF;AApBD,4BAoBC;AAED,MAAa,iCAAkC,SAAQ,0BAAkC;CAAG;AAA5F,8EAA4F;AA0G5F,QAAQ,CAAC,iCAAiC,GAAG,iCAAiC,CAAC;AAC/E,QAAQ,CAAC,QAAQ,GAAG,mBAAQ,CAAC;AAC7B,QAAQ,CAAC,gCAAgC,GAAG,2CAAgC,CAAC;AAC7E,QAAQ,CAAC,KAAK,GAAG,aAAK,CAAC;AACvB,QAAQ,CAAC,8BAA8B,GAAG,sCAA8B,CAAC"}

package/resources/projects/projects.mjs

@@ -3,7 +3,7 @@ import { APIResource } from "../../resource.mjs";
 import * as BranchesAPI from "./branches.mjs";
 import { BranchListResponsesPageCursorURL, Branches, } from "./branches.mjs";
 import * as FilesAPI from "./files.mjs";
-import { FileListResponsesPageCursorURL, Files } from "./files.mjs";
+import { FileListResponsesPageCursorURL, Files, } from "./files.mjs";
 import { PageCursorURL } from "../../pagination.mjs";
 /**
  * Projects let you organize multiple files and collaborate with pull requests

package/resources/projects/projects.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"projects.mjs","sourceRoot":"","sources":["../../src/resources/projects/projects.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,KAAK,WAAW;OAChB,EAGL,gCAAgC,EAEhC,QAAQ,GACT;OACM,KAAK,QAAQ;OACb,EAAoC,8BAA8B,EAAE,KAAK,EAAE;OAC3E,EAAE,aAAa,EAA4B;AAElD;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,WAAW;IAAzC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAkB3D,CAAC;IAhBC;;OAEG;IACH,QAAQ,CAAC,SAAiB,EAAE,OAA6B;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED;;OAEG;IACH,IAAI,CACF,KAAwB,EACxB,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,iCAAiC,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3G,CAAC;CACF;AAED,MAAM,OAAO,iCAAkC,SAAQ,aAAkC;CAAG;AAwF5F,QAAQ,CAAC,iCAAiC,GAAG,iCAAiC,CAAC;AAC/E,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC;AAC7B,QAAQ,CAAC,gCAAgC,GAAG,gCAAgC,CAAC;AAC7E,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;AACvB,QAAQ,CAAC,8BAA8B,GAAG,8BAA8B,CAAC"}
+{"version":3,"file":"projects.mjs","sourceRoot":"","sources":["../../src/resources/projects/projects.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,KAAK,WAAW;OAChB,EAGL,gCAAgC,EAEhC,QAAQ,GACT;OACM,KAAK,QAAQ;OACb,EAKL,8BAA8B,EAG9B,KAAK,GACN;OACM,EAAE,aAAa,EAA4B;AAElD;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,WAAW;IAAzC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAkB3D,CAAC;IAhBC;;OAEG;IACH,QAAQ,CAAC,SAAiB,EAAE,OAA6B;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED;;OAEG;IACH,IAAI,CACF,KAAwB,EACxB,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,iCAAiC,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3G,CAAC;CACF;AAED,MAAM,OAAO,iCAAkC,SAAQ,aAAkC;CAAG;AA0G5F,QAAQ,CAAC,iCAAiC,GAAG,iCAAiC,CAAC;AAC/E,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC;AAC7B,QAAQ,CAAC,gCAAgC,GAAG,gCAAgC,CAAC;AAC7E,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;AACvB,QAAQ,CAAC,8BAA8B,GAAG,8BAA8B,CAAC"}

package/src/resources/alias/username/index.ts

@@ -1,4 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export { ProjectName, type ProjectNameRetrieveResponse } from './project-name';
 export { Username } from './username';
 export { ValName, type ValNameRetrieveResponse } from './val-name';

package/src/resources/alias/username/project-name.ts

@@ -0,0 +1,72 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../resource';
+import * as Core from '../../../core';
+
+export class ProjectName extends APIResource {
+  /**
+   * Get a project
+   */
+  retrieve(
+    username: string,
+    projectName: string,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<ProjectNameRetrieveResponse> {
+    return this._client.get(`/v1/alias/projects/${username}/${projectName}`, options);
+  }
+}
+
+/**
+ * A Project
+ */
+export interface ProjectNameRetrieveResponse {
+  /**
+   * The id of the project
+   */
+  id: string;
+
+  author: ProjectNameRetrieveResponse.Author;
+
+  createdAt: string;
+
+  description: string | null;
+
+  /**
+   * The URL of this project's image
+   */
+  imageUrl: string | null;
+
+  links: ProjectNameRetrieveResponse.Links;
+
+  name: string;
+
+  /**
+   * This resource's privacy setting. Unlisted resources do not appear on profile
+   * pages or elsewhere, but you can link to them.
+   */
+  privacy: 'public' | 'unlisted' | 'private';
+}
+
+export namespace ProjectNameRetrieveResponse {
+  export interface Author {
+    id: string;
+
+    username: string | null;
+  }
+
+  export interface Links {
+    /**
+     * The URL of this resource on Val Town
+     */
+    html: string;
+
+    /**
+     * The URL of this resource on this API
+     */
+    self: string;
+  }
+}
+
+export declare namespace ProjectName {
+  export { type ProjectNameRetrieveResponse as ProjectNameRetrieveResponse };
+}

package/src/resources/alias/username/username.ts

@@ -3,11 +3,14 @@
 import { APIResource } from '../../../resource';
 import * as Core from '../../../core';
 import * as Shared from '../../shared';
+import * as ProjectNameAPI from './project-name';
+import { ProjectName, ProjectNameRetrieveResponse } from './project-name';
 import * as ValNameAPI from './val-name';
 import { ValName, ValNameRetrieveResponse } from './val-name';
 
 export class Username extends APIResource {
   valName: ValNameAPI.ValName = new ValNameAPI.ValName(this._client);
+  projectName: ProjectNameAPI.ProjectName = new ProjectNameAPI.ProjectName(this._client);
 
   /**
    * Get basic details about a user, given their username
@@ -18,7 +21,10 @@ export class Username extends APIResource {
 }
 
 Username.ValName = ValName;
+Username.ProjectName = ProjectName;
 
 export declare namespace Username {
   export { ValName as ValName, type ValNameRetrieveResponse as ValNameRetrieveResponse };
+
+  export { ProjectName as ProjectName, type ProjectNameRetrieveResponse as ProjectNameRetrieveResponse };
 }

package/src/resources/me/projects.ts

@@ -41,6 +41,8 @@ export interface ProjectListResponse {
    */
   imageUrl: string | null;
 
+  links: ProjectListResponse.Links;
+
   name: string;
 
   /**
@@ -48,11 +50,6 @@ export interface ProjectListResponse {
    * pages or elsewhere, but you can link to them.
    */
   privacy: 'public' | 'unlisted' | 'private';
-
-  /**
-   * The URL of this resource on the Val Town website
-   */
-  valTownUrl: string;
 }
 
 export namespace ProjectListResponse {
@@ -61,6 +58,18 @@ export namespace ProjectListResponse {
 
     username: string | null;
   }
+
+  export interface Links {
+    /**
+     * The URL of this resource on Val Town
+     */
+    html: string;
+
+    /**
+     * The URL of this resource on this API
+     */
+    self: string;
+  }
 }
 
 export interface ProjectListParams extends PageCursorURLParams {}

package/src/resources/projects/branches.ts

@@ -49,18 +49,29 @@ export interface BranchRetrieveResponse {
    */
   forkedBranchId: string | null;
 
+  links: BranchRetrieveResponse.Links;
+
   name: string;
 
   updatedAt: string;
 
-  /**
-   * The URL of this resource on the Val Town website
-   */
-  valTownUrl: string;
-
   version: number;
 }
 
+export namespace BranchRetrieveResponse {
+  export interface Links {
+    /**
+     * The URL of this resource on Val Town
+     */
+    html: string;
+
+    /**
+     * The URL of this resource on this API
+     */
+    self: string;
+  }
+}
+
 /**
  * A Branch
  */
@@ -77,18 +88,29 @@ export interface BranchListResponse {
    */
   forkedBranchId: string | null;
 
+  links: BranchListResponse.Links;
+
   name: string;
 
   updatedAt: string;
 
-  /**
-   * The URL of this resource on the Val Town website
-   */
-  valTownUrl: string;
-
   version: number;
 }
 
+export namespace BranchListResponse {
+  export interface Links {
+    /**
+     * The URL of this resource on Val Town
+     */
+    html: string;
+
+    /**
+     * The URL of this resource on this API
+     */
+    self: string;
+  }
+}
+
 export interface BranchListParams extends PageCursorURLParams {}
 
 Branches.BranchListResponsesPageCursorURL = BranchListResponsesPageCursorURL;

package/src/resources/projects/files.ts

@@ -1,10 +1,24 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../resource';
+import { isRequestOptions } from '../../core';
 import * as Core from '../../core';
+import * as Shared from '../shared';
 import { PageCursorURL, type PageCursorURLParams } from '../../pagination';
 
 export class Files extends APIResource {
+  /**
+   * Get metadata for files and directories in a project at the specified path
+   */
+  retrieve(
+    projectId: string,
+    path: string,
+    query: FileRetrieveParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<FileRetrieveResponse> {
+    return this._client.get(`/v1/projects/${projectId}/files/${path}`, { query, ...options });
+  }
+
   /**
    * Get metadata for files and directories in a project at the root directory
    */
@@ -18,10 +32,111 @@ export class Files extends APIResource {
       ...options,
     });
   }
+
+  /**
+   * Download file content
+   */
+  content(
+    projectId: string,
+    path: string,
+    params?: FileContentParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<unknown>;
+  content(projectId: string, path: string, options?: Core.RequestOptions): Core.APIPromise<unknown>;
+  content(
+    projectId: string,
+    path: string,
+    params: FileContentParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<unknown> {
+    if (isRequestOptions(params)) {
+      return this.content(projectId, path, {}, params);
+    }
+    const {
+      'Cache-Control': cacheControl,
+      'If-Match': ifMatch,
+      'If-Modified-Since': ifModifiedSince,
+      'If-None-Match': ifNoneMatch,
+      'If-Unmodified-Since': ifUnmodifiedSince,
+      ...query
+    } = params;
+    return this._client.get(`/v1/projects/${projectId}/files/${path}/content`, {
+      query,
+      ...options,
+      headers: {
+        ...(cacheControl != null ? { 'Cache-Control': cacheControl } : undefined),
+        ...(ifMatch != null ? { 'If-Match': ifMatch } : undefined),
+        ...(ifModifiedSince != null ? { 'If-Modified-Since': ifModifiedSince } : undefined),
+        ...(ifNoneMatch != null ? { 'If-None-Match': ifNoneMatch } : undefined),
+        ...(ifUnmodifiedSince != null ? { 'If-Unmodified-Since': ifUnmodifiedSince } : undefined),
+        ...options?.headers,
+      },
+    });
+  }
 }
 
 export class FileListResponsesPageCursorURL extends PageCursorURL<FileListResponse> {}
 
+/**
+ * A paginated result set
+ */
+export interface FileRetrieveResponse {
+  data: Array<FileRetrieveResponse.Data>;
+
+  /**
+   * Links to use for pagination
+   */
+  links: Shared.PaginationLinks;
+}
+
+export namespace FileRetrieveResponse {
+  /**
+   * A File or Directory's Metadata
+   */
+  export interface Data {
+    /**
+     * The id of the resource
+     */
+    id: string;
+
+    links: Data.Links;
+
+    name: string;
+
+    path: string;
+
+    type: 'directory' | 'file' | 'interval' | 'http' | 'email' | 'script';
+
+    updatedAt: string;
+
+    version: number;
+  }
+
+  export namespace Data {
+    export interface Links {
+      /**
+       * The URL of this resource on Val Town
+       */
+      html: string;
+
+      /**
+       * The URL of this resource's source code as a module
+       */
+      module: string;
+
+      /**
+       * The URL of this resource on this API
+       */
+      self: string;
+
+      /**
+       * This resource's web endpoint, where it serves a website or API
+       */
+      endpoint?: string;
+    }
+  }
+}
+
 /**
  * A File or Directory's Metadata
  */
@@ -46,16 +161,52 @@ export interface FileListResponse {
 
 export namespace FileListResponse {
   export interface Links {
-    endpoint: string | null;
-
+    /**
+     * The URL of this resource on Val Town
+     */
     html: string;
 
+    /**
+     * The URL of this resource's source code as a module
+     */
     module: string;
 
-    self: string | null;
+    /**
+     * The URL of this resource on this API
+     */
+    self: string;
+
+    /**
+     * This resource's web endpoint, where it serves a website or API
+     */
+    endpoint?: string;
   }
 }
 
+export type FileContentResponse = unknown;
+
+export interface FileRetrieveParams {
+  /**
+   * Maximum items to return in each paginated response
+   */
+  limit: number;
+
+  /**
+   * Number of items to skip in order to deliver paginated results
+   */
+  offset: number;
+
+  /**
+   * Id to query
+   */
+  branch_id?: string;
+
+  /**
+   * Specific branch version to query
+   */
+  version?: number;
+}
+
 export interface FileListParams extends PageCursorURLParams {
   /**
    * Id to query
@@ -73,12 +224,53 @@ export interface FileListParams extends PageCursorURLParams {
   version?: number;
 }
 
+export interface FileContentParams {
+  /**
+   * Query param: Id to query
+   */
+  branch_id?: string;
+
+  /**
+   * Query param: Specific branch version to query
+   */
+  version?: number;
+
+  /**
+   * Header param:
+   */
+  'Cache-Control'?: string;
+
+  /**
+   * Header param:
+   */
+  'If-Match'?: string;
+
+  /**
+   * Header param:
+   */
+  'If-Modified-Since'?: string;
+
+  /**
+   * Header param:
+   */
+  'If-None-Match'?: string;
+
+  /**
+   * Header param:
+   */
+  'If-Unmodified-Since'?: string;
+}
+
 Files.FileListResponsesPageCursorURL = FileListResponsesPageCursorURL;
 
 export declare namespace Files {
   export {
+    type FileRetrieveResponse as FileRetrieveResponse,
     type FileListResponse as FileListResponse,
+    type FileContentResponse as FileContentResponse,
     FileListResponsesPageCursorURL as FileListResponsesPageCursorURL,
+    type FileRetrieveParams as FileRetrieveParams,
     type FileListParams as FileListParams,
+    type FileContentParams as FileContentParams,
   };
 }