@valtown/sdk 0.7.0 → 0.9.0

package/resources/vals/vals.d.ts

@@ -3,6 +3,9 @@ import * as Core from '@valtown/sdk/core';
 import * as ValsAPI from '@valtown/sdk/resources/vals/vals';
 import * as Shared from '@valtown/sdk/resources/shared';
 import * as VersionsAPI from '@valtown/sdk/resources/vals/versions';
+/**
+ * Vals are runnable JavaScript, TypeScript, and JSX modules
+ */
 export declare class Vals extends APIResource {
     versions: VersionsAPI.Versions;
     /**
@@ -30,20 +33,6 @@ export declare class Vals extends APIResource {
      * Run an existing val or create a new one
      */
     createOrUpdate(body: ValCreateOrUpdateParams, options?: Core.RequestOptions): Core.APIPromise<void>;
-    /**
-     * Run a val, with arguments in the request body
-     */
-    run(valname: string, body?: ValRunParams, options?: Core.RequestOptions): Core.APIPromise<void>;
-    run(valname: string, options?: Core.RequestOptions): Core.APIPromise<void>;
-    /**
-     * Run JavaScript or TypeScript without saving it permanently as a val
-     */
-    runAnonymous(body: ValRunAnonymousParams, options?: Core.RequestOptions): Core.APIPromise<ValRunAnonymousResponse | null>;
-    /**
-     * Run a val, specify any parameters in a querystring
-     */
-    runGet(valname: string, query?: ValRunGetParams, options?: Core.RequestOptions): Core.APIPromise<void>;
-    runGet(valname: string, options?: Core.RequestOptions): Core.APIPromise<void>;
 }
 /**
  * The evaluation_id was successfully searched for and the evaluation was either
@@ -55,7 +44,6 @@ export interface ValCancelEvaluationResponse {
      */
     found: boolean;
 }
-export type ValRunAnonymousResponse = string | number | Record<string, unknown> | Array<unknown> | boolean;
 export interface ValCreateParams {
     /**
      * Val source code as TypeScript
@@ -110,34 +98,11 @@ export interface ValCreateOrUpdateParams {
      */
     name: string;
 }
-export interface ValRunParams {
-    args?: Array<unknown>;
-}
-export interface ValRunAnonymousParams {
-    /**
-     * TypeScript source code
-     */
-    code: string;
-    /**
-     * Array of arguments passed to the given function
-     */
-    args?: Array<unknown>;
-}
-export interface ValRunGetParams {
-    /**
-     * An argument that will be passed to the function as a JavaScript value
-     */
-    args?: string;
-}
 export declare namespace Vals {
     export import ValCancelEvaluationResponse = ValsAPI.ValCancelEvaluationResponse;
-    export import ValRunAnonymousResponse = ValsAPI.ValRunAnonymousResponse;
     export import ValCreateParams = ValsAPI.ValCreateParams;
     export import ValUpdateParams = ValsAPI.ValUpdateParams;
     export import ValCreateOrUpdateParams = ValsAPI.ValCreateOrUpdateParams;
-    export import ValRunParams = ValsAPI.ValRunParams;
-    export import ValRunAnonymousParams = ValsAPI.ValRunAnonymousParams;
-    export import ValRunGetParams = ValsAPI.ValRunGetParams;
     export import Versions = VersionsAPI.Versions;
     export import VersionListResponse = VersionsAPI.VersionListResponse;
     export import VersionListResponsesPageCursorURL = VersionsAPI.VersionListResponsesPageCursorURL;

package/resources/vals/vals.d.ts.map

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

package/resources/vals/vals.js

@@ -28,6 +28,9 @@ exports.Vals = void 0;
 const resource_1 = require("@valtown/sdk/resource");
 const core_1 = require("@valtown/sdk/core");
 const VersionsAPI = __importStar(require("@valtown/sdk/resources/vals/versions"));
+/**
+ * Vals are runnable JavaScript, TypeScript, and JSX modules
+ */
 class Vals extends resource_1.APIResource {
     constructor() {
         super(...arguments);
@@ -80,32 +83,6 @@ class Vals extends resource_1.APIResource {
             headers: { Accept: '*/*', ...options?.headers },
         });
     }
-    run(valname, body = {}, options) {
-        if ((0, core_1.isRequestOptions)(body)) {
-            return this.run(valname, {}, body);
-        }
-        return this._client.post(`/v1/run/${valname}`, {
-            body,
-            ...options,
-            headers: { Accept: '*/*', ...options?.headers },
-        });
-    }
-    /**
-     * Run JavaScript or TypeScript without saving it permanently as a val
-     */
-    runAnonymous(body, options) {
-        return this._client.post('/v1/eval', { body, ...options });
-    }
-    runGet(valname, query = {}, options) {
-        if ((0, core_1.isRequestOptions)(query)) {
-            return this.runGet(valname, {}, query);
-        }
-        return this._client.get(`/v1/run/${valname}`, {
-            query,
-            ...options,
-            headers: { Accept: '*/*', ...options?.headers },
-        });
-    }
 }
 exports.Vals = Vals;
 (function (Vals) {

package/resources/vals/vals.js.map

@@ -1 +1 @@
-{"version":3,"file":"vals.js","sourceRoot":"","sources":["../../src/resources/vals/vals.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"vals.js","sourceRoot":"","sources":["../../src/resources/vals/vals.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;;;;;;;;;;;;;;;;;;;;;;;AAEtF,oDAAoD;AACpD,4CAAqD;AAIrD,kFAAoE;AAEpE;;GAEG;AACH,MAAa,IAAK,SAAQ,sBAAW;IAArC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAmE1E,CAAC;IAjEC;;OAEG;IACH,MAAM,CAAC,IAAqB,EAAE,OAA6B;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAa,EAAE,OAA6B;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAOD,MAAM,CACJ,KAAa,EACb,OAA8C,EAAE,EAChD,OAA6B;QAE7B,IAAI,IAAA,uBAAgB,EAAC,IAAI,CAAC,EAAE;YAC1B,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;SACrC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,EAAE,EAAE;YAC3C,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE;SAChD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAa,EAAE,OAA6B;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,KAAK,EAAE,EAAE;YAC9C,GAAG,OAAO;YACV,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE;SAChD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,gBAAgB,CACd,KAAa,EACb,YAAoB,EACpB,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,KAAK,gBAAgB,YAAY,SAAS,EAAE,OAAO,CAAC,CAAC;IAC5F,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,IAA6B,EAAE,OAA6B;QACzE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE;YAClC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE;SAChD,CAAC,CAAC;IACL,CAAC;CACF;AApED,oBAoEC;AA8ED,WAAiB,IAAI;IAKL,aAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC;IAEhC,sCAAiC,GAAG,WAAW,CAAC,iCAAiC,CAAC;AAIlG,CAAC,EAXgB,IAAI,GAAJ,YAAI,KAAJ,YAAI,QAWpB"}

package/resources/vals/vals.mjs

@@ -2,6 +2,9 @@
 import { APIResource } from '@valtown/sdk/resource';
 import { isRequestOptions } from '@valtown/sdk/core';
 import * as VersionsAPI from '@valtown/sdk/resources/vals/versions';
+/**
+ * Vals are runnable JavaScript, TypeScript, and JSX modules
+ */
 export class Vals extends APIResource {
     constructor() {
         super(...arguments);
@@ -54,32 +57,6 @@ export class Vals extends APIResource {
             headers: { Accept: '*/*', ...options?.headers },
         });
     }
-    run(valname, body = {}, options) {
-        if (isRequestOptions(body)) {
-            return this.run(valname, {}, body);
-        }
-        return this._client.post(`/v1/run/${valname}`, {
-            body,
-            ...options,
-            headers: { Accept: '*/*', ...options?.headers },
-        });
-    }
-    /**
-     * Run JavaScript or TypeScript without saving it permanently as a val
-     */
-    runAnonymous(body, options) {
-        return this._client.post('/v1/eval', { body, ...options });
-    }
-    runGet(valname, query = {}, options) {
-        if (isRequestOptions(query)) {
-            return this.runGet(valname, {}, query);
-        }
-        return this._client.get(`/v1/run/${valname}`, {
-            query,
-            ...options,
-            headers: { Accept: '*/*', ...options?.headers },
-        });
-    }
 }
 (function (Vals) {
     Vals.Versions = VersionsAPI.Versions;

package/resources/vals/vals.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"vals.mjs","sourceRoot":"","sources":["../../src/resources/vals/vals.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"vals.mjs","sourceRoot":"","sources":["../../src/resources/vals/vals.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE,MAAM,uBAAuB;OAC5C,EAAE,gBAAgB,EAAE,MAAM,mBAAmB;OAI7C,KAAK,WAAW,MAAM,sCAAsC;AAEnE;;GAEG;AACH,MAAM,OAAO,IAAK,SAAQ,WAAW;IAArC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAmE1E,CAAC;IAjEC;;OAEG;IACH,MAAM,CAAC,IAAqB,EAAE,OAA6B;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAa,EAAE,OAA6B;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAOD,MAAM,CACJ,KAAa,EACb,OAA8C,EAAE,EAChD,OAA6B;QAE7B,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE;YAC1B,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;SACrC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,EAAE,EAAE;YAC3C,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE;SAChD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAa,EAAE,OAA6B;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,KAAK,EAAE,EAAE;YAC9C,GAAG,OAAO;YACV,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE;SAChD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,gBAAgB,CACd,KAAa,EACb,YAAoB,EACpB,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,KAAK,gBAAgB,YAAY,SAAS,EAAE,OAAO,CAAC,CAAC;IAC5F,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,IAA6B,EAAE,OAA6B;QACzE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE;YAClC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE;SAChD,CAAC,CAAC;IACL,CAAC;CACF;AA8ED,WAAiB,IAAI;IAKL,aAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC;IAEhC,sCAAiC,GAAG,WAAW,CAAC,iCAAiC,CAAC;AAIlG,CAAC,EAXgB,IAAI,KAAJ,IAAI,QAWpB"}

package/src/index.ts

@@ -120,14 +120,38 @@ export class ValTown extends Core.APIClient {
     this.bearerToken = bearerToken;
   }
 
+  /**
+   * Search endpoint for vals
+   */
   search: API.Search = new API.Search(this);
+  /**
+   * Methods to translate between human-readable names and IDs
+   */
   alias: API.Alias = new API.Alias(this);
+  /**
+   * Methods to get information about your own profile and resources
+   */
   me: API.Me = new API.Me(this);
+  /**
+   * Blob storage lets you store larger objects, including binary data
+   */
   blobs: API.Blobs = new API.Blobs(this);
+  /**
+   * Access public user information and list other people’s vals
+   */
   users: API.Users = new API.Users(this);
+  /**
+   * Vals access a shared SQLite database
+   */
   sqlite: API.Sqlite = new API.Sqlite(this);
-  evals: API.Evals = new API.Evals(this);
+  eval: API.Eval = new API.Eval(this);
+  /**
+   * Vals are runnable JavaScript, TypeScript, and JSX modules
+   */
   vals: API.Vals = new API.Vals(this);
+  /**
+   * Val Town supports sending emails from vals
+   */
   emails: API.Emails = new API.Emails(this);
 
   protected override defaultQuery(): Core.DefaultQuery | undefined {
@@ -209,19 +233,15 @@ export namespace ValTown {
   export import SqliteBatchParams = API.SqliteBatchParams;
   export import SqliteExecuteParams = API.SqliteExecuteParams;
 
-  export import Evals = API.Evals;
-  export import EvalRunCodeResponse = API.EvalRunCodeResponse;
-  export import EvalRunCodeParams = API.EvalRunCodeParams;
+  export import Eval = API.Eval;
+  export import EvalRunResponse = API.EvalRunResponse;
+  export import EvalRunParams = API.EvalRunParams;
 
   export import Vals = API.Vals;
   export import ValCancelEvaluationResponse = API.ValCancelEvaluationResponse;
-  export import ValRunAnonymousResponse = API.ValRunAnonymousResponse;
   export import ValCreateParams = API.ValCreateParams;
   export import ValUpdateParams = API.ValUpdateParams;
   export import ValCreateOrUpdateParams = API.ValCreateOrUpdateParams;
-  export import ValRunParams = API.ValRunParams;
-  export import ValRunAnonymousParams = API.ValRunAnonymousParams;
-  export import ValRunGetParams = API.ValRunGetParams;
 
   export import Emails = API.Emails;
   export import EmailSendResponse = API.EmailSendResponse;

package/src/resources/alias/alias.ts

@@ -3,6 +3,9 @@
 import { APIResource } from "../../resource";
 import * as UsernameAPI from "./username/username";
 
+/**
+ * Methods to translate between human-readable names and IDs
+ */
 export class Alias extends APIResource {
   username: UsernameAPI.Username = new UsernameAPI.Username(this._client);
 }

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

@@ -38,8 +38,13 @@ export interface ValNameRetrieveResponse {
 
   createdAt: string;
 
+  /**
+   * How many likes this val has received
+   */
   likeCount: number;
 
+  links: ValNameRetrieveResponse.Links;
+
   /**
    * The name of this val
    */
@@ -56,6 +61,9 @@ export interface ValNameRetrieveResponse {
    */
   public: boolean;
 
+  /**
+   * This val’s readme, as Markdown
+   */
   readme: string | null;
 
   referenceCount: number;
@@ -86,6 +94,18 @@ export namespace ValNameRetrieveResponse {
 
     username: string | null;
   }
+
+  export interface Links {
+    /**
+     * The URL of this val on this API
+     */
+    self: string;
+
+    /**
+     * The endpoint to retrieve this val’s versions
+     */
+    versions: string;
+  }
 }
 
 export namespace ValName {

package/src/resources/blobs.ts

@@ -6,6 +6,9 @@ import * as Core from "../core";
 import * as BlobsAPI from "./blobs";
 import { type Response } from "../_shims/index";
 
+/**
+ * Blob storage lets you store larger objects, including binary data
+ */
 export class Blobs extends APIResource {
   /**
    * List blobs in your account

package/src/resources/emails.ts

@@ -5,6 +5,9 @@ import { isRequestOptions } from "../core";
 import * as Core from "../core";
 import * as EmailsAPI from "./emails";
 
+/**
+ * Val Town supports sending emails from vals
+ */
 export class Emails extends APIResource {
   /**
    * Send emails

package/src/resources/eval.ts

@@ -0,0 +1,36 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from "../resource";
+import * as Core from "../core";
+import * as EvalAPI from "./eval";
+
+export class Eval extends APIResource {
+  /**
+   * Run JavaScript or TypeScript without saving it permanently as a val
+   */
+  run(body: EvalRunParams, options?: Core.RequestOptions): Core.APIPromise<EvalRunResponse | null> {
+    return this._client.post('/v1/eval', { body, ...options });
+  }
+}
+
+export type EvalRunResponse = string | number | Record<string, unknown> | Array<unknown> | boolean;
+
+export interface EvalRunParams {
+  /**
+   * TypeScript source code
+   */
+  code: string;
+
+  /**
+   * Array of arguments passed to the given function. If this is present, the default
+   * export should be a function and will be called with these arguments, and the
+   * function result will be returned. If `args` is not present, no function calls
+   * are made, but you can still return a value using `export default myVariable`.
+   */
+  args?: Array<unknown>;
+}
+
+export namespace Eval {
+  export import EvalRunResponse = EvalAPI.EvalRunResponse;
+  export import EvalRunParams = EvalAPI.EvalRunParams;
+}

package/src/resources/index.ts

@@ -4,19 +4,15 @@ export * from './shared';
 export { Alias } from './alias/alias';
 export { BlobListResponse, BlobListParams, BlobStoreParams, Blobs } from './blobs';
 export { EmailSendResponse, EmailSendParams, Emails } from './emails';
-export { EvalRunCodeResponse, EvalRunCodeParams, Evals } from './evals';
+export { EvalRunResponse, EvalRunParams, Eval } from './eval';
 export { Me } from './me/me';
 export { Search } from './search/search';
 export { SqliteBatchResponse, SqliteBatchParams, SqliteExecuteParams, Sqlite } from './sqlite';
 export { Users } from './users/users';
 export {
   ValCancelEvaluationResponse,
-  ValRunAnonymousResponse,
   ValCreateParams,
   ValUpdateParams,
   ValCreateOrUpdateParams,
-  ValRunParams,
-  ValRunAnonymousParams,
-  ValRunGetParams,
   Vals,
 } from './vals/vals';

package/src/resources/me/me.ts

@@ -6,6 +6,9 @@ import * as LikesAPI from "./likes";
 import * as ProfileAPI from "./profile";
 import * as ReferencesAPI from "./references";
 
+/**
+ * Methods to get information about your own profile and resources
+ */
 export class Me extends APIResource {
   profile: ProfileAPI.Profile = new ProfileAPI.Profile(this._client);
   likes: LikesAPI.Likes = new LikesAPI.Likes(this._client);

package/src/resources/me/profile.ts

@@ -17,6 +17,9 @@ export class Profile extends APIResource {
  * Your user information, with tier and email included
  */
 export interface ProfileRetrieveResponse {
+  /**
+   * The ID of this user
+   */
   id: string;
 
   /**
@@ -29,6 +32,8 @@ export interface ProfileRetrieveResponse {
    */
   email: string;
 
+  links: ProfileRetrieveResponse.Links;
+
   /**
    * URL that points to the user’s profile image, if one exists
    */
@@ -39,12 +44,26 @@ export interface ProfileRetrieveResponse {
    */
   tier: 'free' | 'pro' | null;
 
+  /**
+   * URL of this user’s profile on Val Town’s website
+   */
+  url: string;
+
   /**
    * The user’s handle that they chose for themselves. Does not include the @ symbol
    */
   username: string | null;
 }
 
+export namespace ProfileRetrieveResponse {
+  export interface Links {
+    /**
+     * URL of this user on this API
+     */
+    self: string;
+  }
+}
+
 export namespace Profile {
   export import ProfileRetrieveResponse = ProfileAPI.ProfileRetrieveResponse;
 }

package/src/resources/me/references.ts

@@ -22,32 +22,72 @@ export class References extends APIResource {
 
 export class ReferenceListResponsesPageCursorURL extends PageCursorURL<ReferenceListResponse> {}
 
+/**
+ * A description of a dependency from one val (reference) to another (dependsOn)
+ * that was introduced at a particular time.
+ */
 export interface ReferenceListResponse {
+  /**
+   * A val in a dependency relationship
+   */
   dependsOn: ReferenceListResponse.DependsOn;
 
+  /**
+   * A val in a dependency relationship
+   */
   reference: ReferenceListResponse.Reference;
 
   referencedAt: string;
 }
 
 export namespace ReferenceListResponse {
+  /**
+   * A val in a dependency relationship
+   */
   export interface DependsOn {
+    /**
+     * The id of this val
+     */
     id: string;
 
+    /**
+     * The ID of the person who authored this val
+     */
     author_id: string | null;
 
+    /**
+     * The name of this val
+     */
     name: string;
 
+    /**
+     * The username of the person who authored this val
+     */
     username: string | null;
   }
 
+  /**
+   * A val in a dependency relationship
+   */
   export interface Reference {
+    /**
+     * The id of this val
+     */
     id: string;
 
+    /**
+     * The ID of the person who authored this val
+     */
     author_id: string | null;
 
+    /**
+     * The name of this val
+     */
     name: string;
 
+    /**
+     * The username of the person who authored this val
+     */
     username: string | null;
   }
 }

package/src/resources/search/search.ts

@@ -3,6 +3,9 @@
 import { APIResource } from "../../resource";
 import * as ValsAPI from "./vals";
 
+/**
+ * Search endpoint for vals
+ */
 export class Search extends APIResource {
   vals: ValsAPI.Vals = new ValsAPI.Vals(this._client);
 }

package/src/resources/shared.ts

@@ -23,6 +23,8 @@ export interface BasicVal {
 
   createdAt: string;
 
+  links: BasicVal.Links;
+
   /**
    * The name of this val
    */
@@ -65,6 +67,18 @@ export namespace BasicVal {
 
     username: string | null;
   }
+
+  export interface Links {
+    /**
+     * The URL of this val on this API
+     */
+    self: string;
+
+    /**
+     * The endpoint to retrieve this val’s versions
+     */
+    versions: string;
+  }
 }
 
 /**
@@ -88,8 +102,13 @@ export interface ExtendedVal {
 
   createdAt: string;
 
+  /**
+   * How many likes this val has received
+   */
   likeCount: number;
 
+  links: ExtendedVal.Links;
+
   /**
    * The name of this val
    */
@@ -106,6 +125,9 @@ export interface ExtendedVal {
    */
   public: boolean;
 
+  /**
+   * This val’s readme, as Markdown
+   */
   readme: string | null;
 
   referenceCount: number;
@@ -136,6 +158,18 @@ export namespace ExtendedVal {
 
     username: string | null;
   }
+
+  export interface Links {
+    /**
+     * The URL of this val on this API
+     */
+    self: string;
+
+    /**
+     * The endpoint to retrieve this val’s versions
+     */
+    versions: string;
+  }
 }
 
 /**
@@ -206,6 +240,9 @@ export interface ResultSet {
  * User object
  */
 export interface User {
+  /**
+   * The ID of this user
+   */
   id: string;
 
   /**
@@ -213,15 +250,31 @@ export interface User {
    */
   bio: string | null;
 
+  links: User.Links;
+
   /**
    * URL that points to the user’s profile image, if one exists
    */
   profileImageUrl: string | null;
 
+  /**
+   * URL of this user’s profile on Val Town’s website
+   */
+  url: string;
+
   /**
    * The user’s handle that they chose for themselves. Does not include the @ symbol
    */
   username: string | null;
 }
 
+export namespace User {
+  export interface Links {
+    /**
+     * URL of this user on this API
+     */
+    self: string;
+  }
+}
+
 export class BasicValsPageCursorURL extends PageCursorURL<BasicVal> {}

package/src/resources/sqlite.ts

@@ -5,6 +5,9 @@ import * as Core from "../core";
 import * as SqliteAPI from "./sqlite";
 import * as Shared from "./shared";
 
+/**
+ * Vals access a shared SQLite database
+ */
 export class Sqlite extends APIResource {
   /**
    * Execute a batch of SQLite statements and return results for all of them

package/src/resources/users/users.ts

@@ -5,6 +5,9 @@ import * as Core from "../../core";
 import * as Shared from "../shared";
 import * as ValsAPI from "./vals";
 
+/**
+ * Access public user information and list other people’s vals
+ */
 export class Users extends APIResource {
   vals: ValsAPI.Vals = new ValsAPI.Vals(this._client);