@awesomate/sdk 0.27.0 → 0.29.0

package/dist/index.d.ts

@@ -26,7 +26,7 @@
  * Docs: https://hub.awesomate.ai/docs/sdk/
  */
 /** This package's version, sent to the hub with every server call. */
-export declare const VERSION = "0.27.0";
+export declare const VERSION = "0.29.0";
 /** Augmented by the generated awesomate.d.ts, so each kind's rows are typed. */
 export interface Kinds {
 }
@@ -944,6 +944,19 @@ export declare class AwesomateClient {
          * columns and rows, plus what it assumed.
          */
         data: (query: KnowledgeDataQuery) => Promise<Record<string, unknown>>;
+        /**
+         * A video the owner shared with **Anyone can watch**: its permanent player link and an embed
+         * code for a web page. `link` and `embed` are null until the video is shared, and when it is no
+         * longer Public (`enabled` true, `watchable` false). Read only: sharing is switched on in the hub
+         * or through Claude Code, by an Owner. `title` names the video in the embed code.
+         *
+         * @example
+         * const v = await db.knowledge.video('src-quote-walkthrough', { title: 'How we quote a job' });
+         * if (v.watchable && v.embed) console.log(v.embed);
+         */
+        video: (sourceId: string, options?: {
+            title?: string;
+        }) => Promise<SharedVideo>;
     };
     /**
      * Tell Contacts something happened to someone ("job_paid", "quote_sent"), so any email series
@@ -2261,6 +2274,17 @@ export interface KnowledgeSearchHit {
     url?: string;
     poster_url?: string;
 }
+/** A video anyone can watch, from knowledge.video(). */
+export interface SharedVideo {
+    /** The owner switched Anyone can watch on. */
+    enabled: boolean;
+    /** Switched on and the video still Public: what a viewer gets. */
+    watchable: boolean;
+    /** The permanent player page, on the account's own links. address when it has one; null until shared. */
+    link: string | null;
+    /** An iframe of the player for a web page; null until shared. */
+    embed: string | null;
+}
 /** What knowledge.search() returns. */
 export interface KnowledgeSearchResult {
     query: string;
@@ -2439,6 +2463,45 @@ export interface VoiceSession {
     }>;
     say_as: Record<string, string>;
 }
+/** One field on a record page: its value as this person may read it, and whether they may change it. */
+export interface RecordPageField {
+    key: string;
+    label: string;
+    type: string;
+    value: unknown;
+    change: boolean;
+}
+/** One section on a record page, in the order the account set; `folded` sections start closed. */
+export interface RecordPageSection {
+    key: string;
+    label: string;
+    folded: boolean;
+    fields: RecordPageField[];
+}
+/** A record laid out for the signed-in person's app role (`app.recordPage`). */
+export interface RecordPage {
+    kind: {
+        key: string;
+        label: string;
+        labelPlural: string;
+    };
+    id: string;
+    /** Where it is up to, in the account's words for people outside the team. Null when there are none to show. */
+    stage: {
+        label: string;
+        closed: boolean;
+    } | null;
+    /** Read only from its stage on: nothing on it can be changed. */
+    locked: boolean;
+    /** Whether this person may change the record at all. Each field's `change` says which. */
+    canWrite: boolean;
+    sections: RecordPageSection[];
+    /** Fields the account keeps at the top of the page, in order. */
+    pinned: string[];
+    /** The part of the page it opens on. */
+    tab: 'details' | 'activity' | 'related';
+    asAt: string;
+}
 /**
  * The browser client for one of the account's apps, from createAppClient(): sign-in is under
  * `auth`, and every data call runs as the signed-in person, inside the account's access rules.
@@ -2525,6 +2588,20 @@ export declare class AwesomateAppClient {
      * else names no record, so it answers null without asking the hub. Pro and above.
      */
     get<K extends KindName>(kind: K, id: string): Promise<RowOf<K> | null>;
+    /**
+     * One record laid out for this person: the sections and fields their app role is shown, in the
+     * order the account set for that role, each field with its value and whether they may change it,
+     * and where the record is up to in the account's own words for people outside the team. Null when
+     * there is no such record this person may read. The database decides every permission; the
+     * account sets the layout on the record page in the hub ("Viewing as", the role "in your apps").
+     * Needs the account's record pages. A locked record says `locked: true`, and a change to it fails
+     * with `forbidden` and `serverCode: 'locked'`.
+     *
+     * @example
+     * const page = await app.recordPage('job', job.id);
+     * for (const section of page?.sections ?? []) console.log(section.label, section.fields.map((f) => f.value));
+     */
+    recordPage<K extends KindName>(kind: K, id: string): Promise<RecordPage | null>;
     /** Create a record (returns its id) or change one with options.id, inside the kind's write rule for this user. Pro and above. */
     write<K extends KindName>(kind: K, data: Partial<RowOf<K>> | Record<string, unknown>, options?: WriteOptions): Promise<string>;
     /** Archive a record, inside the kind's write rule for this person. Pro and above. */

package/dist/index.js

@@ -26,7 +26,7 @@
  * Docs: https://hub.awesomate.ai/docs/sdk/
  */
 /** This package's version, sent to the hub with every server call. */
-export const VERSION = '0.27.0';
+export const VERSION = '0.29.0';
 const DEFAULT_BASE = 'https://hub.awesomate.ai';
 /** Every record and contact id is a UUID; anything else can name no row. */
 const RECORD_ID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
@@ -687,6 +687,20 @@ export class AwesomateClient {
          * columns and rows, plus what it assumed.
          */
         data: (query) => this.request('POST', '/api/knowledge/data/query', query, false),
+        /**
+         * A video the owner shared with **Anyone can watch**: its permanent player link and an embed
+         * code for a web page. `link` and `embed` are null until the video is shared, and when it is no
+         * longer Public (`enabled` true, `watchable` false). Read only: sharing is switched on in the hub
+         * or through Claude Code, by an Owner. `title` names the video in the embed code.
+         *
+         * @example
+         * const v = await db.knowledge.video('src-quote-walkthrough', { title: 'How we quote a job' });
+         * if (v.watchable && v.embed) console.log(v.embed);
+         */
+        video: (sourceId, options = {}) => {
+            const q = new URLSearchParams({ title: (options.title ?? '').slice(0, 100) });
+            return this.request('GET', `/api/knowledge/sources/${encodeURIComponent(sourceId)}/public-video?${q}`);
+        },
     };
     /**
      * Tell Contacts something happened to someone ("job_paid", "quote_sent"), so any email series
@@ -1322,6 +1336,42 @@ export class AwesomateAppClient {
             throw err;
         }
     }
+    /**
+     * One record laid out for this person: the sections and fields their app role is shown, in the
+     * order the account set for that role, each field with its value and whether they may change it,
+     * and where the record is up to in the account's own words for people outside the team. Null when
+     * there is no such record this person may read. The database decides every permission; the
+     * account sets the layout on the record page in the hub ("Viewing as", the role "in your apps").
+     * Needs the account's record pages. A locked record says `locked: true`, and a change to it fails
+     * with `forbidden` and `serverCode: 'locked'`.
+     *
+     * @example
+     * const page = await app.recordPage('job', job.id);
+     * for (const section of page?.sections ?? []) console.log(section.label, section.fields.map((f) => f.value));
+     */
+    async recordPage(kind, id) {
+        if (!RECORD_ID.test(String(id)))
+            return null;
+        try {
+            const r = await this.data('GET', `/records/${encodeURIComponent(kind)}/${encodeURIComponent(String(id))}`);
+            return {
+                kind: { key: r.kind.key, label: r.kind.label, labelPlural: r.kind.label_plural },
+                id: r.id,
+                stage: r.stage,
+                locked: r.locked,
+                canWrite: r.can_write,
+                sections: r.sections,
+                pinned: r.pinned,
+                tab: r.tab,
+                asAt: r.as_at,
+            };
+        }
+        catch (err) {
+            if (err instanceof AwesomateError && err.code === 'not_found')
+                return null;
+            throw err;
+        }
+    }
     /** Create a record (returns its id) or change one with options.id, inside the kind's write rule for this user. Pro and above. */
     async write(kind, data, options = {}) {
         const r = await this.data('POST', '/call', {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awesomate/sdk",
-  "version": "0.27.0",
+  "version": "0.29.0",
   "description": "Your own Awesomate data from Node and the browser: query contacts and app data with generated types, and sign your app's own users in",
   "license": "MIT",
   "type": "module",