attio 0.0.1-experimental.20250311 → 0.0.1-experimental.20250321

package/lib/attio.js

@@ -3,7 +3,6 @@ import { Command } from "commander";
 import { init } from "./commands/init.js";
 import { build } from "./commands/build.js";
 import { dev } from "./commands/dev.js";
-import { connection } from "./commands/connection/index.js";
 import { version } from "./commands/version/index.js";
 const program = new Command();
 program
@@ -13,6 +12,5 @@ program
     .addCommand(init)
     .addCommand(build)
     .addCommand(dev)
-    .addCommand(connection)
     .addCommand(version)
     .parse();

package/lib/commands/version/index.js

@@ -1,9 +1,7 @@
 import { Command } from "commander";
 import { versionCreate } from "./create.js";
 import { versionList } from "./list.js";
-import { versionPublish } from "./publish.js";
 export const version = new Command("version")
     .description("Manage app versions")
     .addCommand(versionCreate)
-    .addCommand(versionList)
-    .addCommand(versionPublish);
+    .addCommand(versionList);

package/lib/machines/init-machine.js

@@ -86,13 +86,18 @@ export const initMachine = setup({
         loadAppInfo: fromPromise(async ({ input: { token, developerSlug, appSlug } }) => {
             const spinner = new Spinner();
             spinner.start("Loading app information...");
-            const appInfo = await getAppInfo({ token, developerSlug, appSlug });
-            if (appInfo === null) {
-                spinner.error("App not found");
-                return null;
+            try {
+                const appInfo = await getAppInfo({ token, developerSlug, appSlug });
+                if (appInfo === null) {
+                    spinner.error("App not found");
+                    return null;
+                }
+                spinner.success(`App found: ${appInfo.title}`);
+                return appInfo;
+            }
+            finally {
+                spinner.stop();
             }
-            spinner.success(`App found: ${appInfo.title}`);
-            return appInfo;
         }),
     },
     actions: {

package/lib/templates/javascript/src/cat-fact.jsx

@@ -0,0 +1,16 @@
+import React from "react"
+import {TextBlock, useAsyncCache} from "attio/client"
+import getCatFact from "./get-cat-fact.server"
+
+export function CatFact({recordId}) {
+  // By passing in the recordId, the result will be cached for each recordId
+  const {
+    values: {catFact},
+    //       ^^^^^^^– this key matches
+    //               vvvvvvv– this key
+  } = useAsyncCache({catFact: [getCatFact, recordId]})
+  //                           ^^^^^^^^^^  ^^^^^^^^
+  //                           async fn    parameter(s)
+
+  return <TextBlock align="center">{`"${catFact}"`}</TextBlock>
+}

package/lib/templates/javascript/src/get-cat-fact.server.js

@@ -0,0 +1,6 @@
+export default async function getCatFact(recordId) {
+    // We don't really need the recordId for this API, but this is how we could use a parameter
+    const response = await fetch(`https://catfact.ninja/fact?${recordId}`)
+    const data = await response.json()
+    return data.fact
+}

package/lib/templates/javascript/src/hello-world-dialog.jsx

@@ -1,10 +1,11 @@
 import React from "react"
 import {TextBlock} from "attio/client"
-import {Advice} from "./advice"
+import {CatFact} from "./cat-fact"
 
-const Loading = () => <TextBlock>Loading advice...</TextBlock>
+const Loading = () => <TextBlock>Loading cat fact...</TextBlock>
 
-export function HelloWorldDialog ({recordId}) {
+export function HelloWorldDialog({recordId}) {
+    // A simple counter to demonstrate that this is just regular React code.
     const [seconds, setSeconds] = React.useState(0)
     React.useEffect(() => {
         const timeout = setTimeout(() => setSeconds(seconds + 1), 1000)
@@ -16,9 +17,9 @@ export function HelloWorldDialog ({recordId}) {
             <TextBlock align="left">
                 I am a dialog. I have been open for: {seconds} second{seconds === 1 ? "" : "s"}
             </TextBlock>
-            {/* The hook in Advice will suspend until the advice is loaded. */}
+            {/* The hook in CatFact will suspend until the cat fact is loaded. */}
             <React.Suspense fallback={<Loading />}>
-                <Advice recordId={recordId} />
+                <CatFact recordId={recordId} />
             </React.Suspense>
         </>
     )

package/lib/templates/typescript/src/cat-fact.tsx

@@ -0,0 +1,16 @@
+import React from "react"
+import {TextBlock, useAsyncCache} from "attio/client"
+import getCatFact from "./get-cat-fact.server"
+
+export function CatFact({recordId}: {recordId: string}) {
+    // By passing in the recordId, the result will be cached for each recordId
+    const {
+        values: {catFact},
+        //       ^^^^^^^– this key matches
+        //               vvvvvvv– this key
+    } = useAsyncCache({catFact: [getCatFact, recordId]})
+    //                           ^^^^^^^^^^  ^^^^^^^^
+    //                           async fn    parameter(s)
+
+    return <TextBlock align="center">{`"${catFact}"`}</TextBlock>
+}

package/lib/templates/typescript/src/get-cat-fact.server.ts

@@ -0,0 +1,6 @@
+export default async function getCatFact(recordId: string): Promise<string> {
+    // We don't really need the recordId for this API, but this is how we could use a parameter
+    const response = await fetch(`https://catfact.ninja/fact?${recordId}`)
+    const data = await response.json()
+    return data.fact
+}

package/lib/templates/typescript/src/hello-world-dialog.tsx

@@ -1,10 +1,11 @@
 import React from "react"
 import {TextBlock} from "attio/client"
-import {Advice} from "./advice"
+import {CatFact} from "./cat-fact"
 
-const Loading = () => <TextBlock>Loading advice...</TextBlock>
+const Loading = () => <TextBlock>Loading cat fact...</TextBlock>
 
 export function HelloWorldDialog({recordId}: {recordId: string}) {
+    // A simple counter to demonstrate that this is just regular React code.
     const [seconds, setSeconds] = React.useState(0)
     React.useEffect(() => {
         const timeout = setTimeout(() => setSeconds(seconds + 1), 1000)
@@ -16,9 +17,9 @@ export function HelloWorldDialog({recordId}: {recordId: string}) {
             <TextBlock align="left">
                 I am a dialog. I have been open for: {seconds} second{seconds === 1 ? "" : "s"}
             </TextBlock>
-            {/* The hook in Advice will suspend until the advice is loaded. */}
+            {/* The hook in CatFact will suspend until the cat fact is loaded. */}
             <React.Suspense fallback={<Loading />}>
-                <Advice recordId={recordId} />
+                <CatFact recordId={recordId} />
             </React.Suspense>
         </>
     )

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "attio",
-  "version": "0.0.1-experimental.20250311",
+  "version": "0.0.1-experimental.20250321",
   "bin": "lib/attio.js",
   "type": "module",
   "files": [

package/lib/api/publish-version.js

@@ -1,15 +0,0 @@
-import { z } from "zod";
-import { API } from "../env.js";
-import { handleError } from "./handle-error.js";
-import { makeHeaders } from "./make-headers.js";
-const publishVersionSchema = z.object({
-    success: z.literal(true),
-});
-export async function publishVersion({ token, devSlug, appId, major, minor, }) {
-    const response = await fetch(`${API}/developer-accounts/${devSlug}/apps/${appId}/prod-versions/${major}/${minor}/publish`, {
-        method: "POST",
-        headers: makeHeaders(token),
-    });
-    await handleError(response);
-    return publishVersionSchema.parse(await response.json());
-}

package/lib/commands/connection/add.js

@@ -1,67 +0,0 @@
-import { Command, Option } from "commander";
-import { createActor } from "xstate";
-import { z } from "zod";
-import { addConnectionMachine } from "../../machines/add-connection-machine.js";
-export const optionsSchema = z.object({
-    label: z.string().optional(),
-    description: z.string().optional(),
-    type: z.enum(["secret", "oauth2-code"]).optional(),
-    authorizeUrl: z
-        .string()
-        .url("Invalid URL, e.g. https://authorization-server.com/authorize")
-        .startsWith("https://", { message: "Must provide secure authorize URL (https://...)" })
-        .optional(),
-    accessTokenUrl: z
-        .string()
-        .url("Invalid URL, e.g. https://authorization-server.com/token")
-        .startsWith("https://", { message: "Must provide secure access token URL (https://...)" })
-        .optional(),
-    scopes: z
-        .string()
-        .refine((value) => value.split(",").every((scope) => scope.trim().length > 0), {
-        message: "Invalid OAuth scopes format. Must be a comma-delimited list of non-empty strings.",
-    })
-        .optional(),
-    clientId: z.string().optional(),
-    clientSecret: z.string().optional(),
-    dev: z.boolean().default(false),
-});
-export const connectionAdd = new Command("add")
-    .description("Create a new connection for your Attio app")
-    .addOption(new Option("--label", "The label for your connection that will be displayed to users"))
-    .addOption(new Option("--description", "A more detailed description of your connection that will be displayed to users"))
-    .addOption(new Option("--type <type>", "The type of connection to create").choices([
-    "secret",
-    "oauth2-code",
-]))
-    .addOption(new Option("--authorize-url <url>", "The authorize URL for OAuth connection"))
-    .addOption(new Option("--access-token-url <url>", "The access token URL for OAuth connection"))
-    .addOption(new Option("--scopes <scopes>", "A comma separated list of scopes for OAuth connection"))
-    .addOption(new Option("--client-id <id>", "The client ID for OAuth connection"))
-    .addOption(new Option("--client-secret <secret>", "The client secret for OAuth connection"))
-    .addOption(new Option("--dev", "Run in development mode (additional debugging info)"))
-    .action((unparsedOptions) => {
-    let options;
-    try {
-        options = optionsSchema.parse(unparsedOptions);
-    }
-    catch (error) {
-        if (error instanceof z.ZodError) {
-            process.stderr.write("\nInvalid options:\n");
-            error.errors.forEach((err) => {
-                process.stderr.write(`- ${err.path.map((p) => String(p).replace(/[A-Z]/g, (m) => `-${m.toLowerCase()}`)).join(".")}: ${err.message}\n`);
-            });
-            process.exit(1);
-        }
-        throw error;
-    }
-    const actor = createActor(addConnectionMachine, {
-        input: options,
-    });
-    if (options.dev) {
-        actor.subscribe((state) => {
-            console.log("state:", state.value);
-        });
-    }
-    actor.start();
-});

package/lib/commands/connection/index.js

@@ -1,9 +0,0 @@
-import { Command } from "commander";
-import { connectionAdd } from "./add.js";
-import { connectionList } from "./list.js";
-import { connectionRemove } from "./remove.js";
-export const connection = new Command("connection")
-    .description("Manage app connections")
-    .addCommand(connectionAdd)
-    .addCommand(connectionList)
-    .addCommand(connectionRemove);

package/lib/commands/connection/list.js

@@ -1,20 +0,0 @@
-import { Command, Option } from "commander";
-import { createActor } from "xstate";
-import { z } from "zod";
-import { listConnectionsMachine } from "../../machines/list-connections-machine.js";
-export const optionsSchema = z.object({
-    dev: z.boolean().default(false),
-});
-export const connectionList = new Command("list")
-    .description("List all connections for the current major version of your Attio app")
-    .addOption(new Option("--dev", "Run in development mode (additional debugging info)"))
-    .action((unparsedOptions) => {
-    const options = optionsSchema.parse(unparsedOptions);
-    const actor = createActor(listConnectionsMachine);
-    if (options.dev) {
-        actor.subscribe((state) => {
-            console.log("state:", state.value);
-        });
-    }
-    actor.start();
-});

package/lib/commands/connection/remove.js

@@ -1,20 +0,0 @@
-import { Command, Option } from "commander";
-import { createActor } from "xstate";
-import { z } from "zod";
-import { removeConnectionMachine } from "../../machines/remove-connection-machine.js";
-export const optionsSchema = z.object({
-    dev: z.boolean().default(false),
-});
-export const connectionRemove = new Command("remove")
-    .description("Remove a connection from your Attio app")
-    .addOption(new Option("--dev", "Run in development mode (additional debugging info)"))
-    .action((unparsedOptions) => {
-    const options = optionsSchema.parse(unparsedOptions);
-    const actor = createActor(removeConnectionMachine);
-    if (options.dev) {
-        actor.subscribe((state) => {
-            console.log("state:", state.value);
-        });
-    }
-    actor.start();
-});

package/lib/commands/version/publish.js

@@ -1,48 +0,0 @@
-import { Argument, Command, Option } from "commander";
-import { createActor } from "xstate";
-import { z } from "zod";
-import { publishVersionMachine } from "../../machines/publish-version-machine.js";
-export const argsSchema = z
-    .string()
-    .regex(/^\d+\.\d+$/, 'Version must be in the format "major.minor" (e.g., "1.0")')
-    .optional()
-    .describe(`The version to invite someone to (e.g: "1.0"). If you don't specify a version, you will be prompted to choose.`);
-export const optionsSchema = z.object({
-    dev: z.boolean().default(false),
-});
-export const versionPublish = new Command("publish")
-    .description("Publish an unpublished production version of your Attio app")
-    .addArgument(new Argument("<version>", `The version to publish (e.g: "1.0"). If you don't specify a version, you will be prompted to choose.`).argOptional())
-    .addOption(new Option("--dev", "Run in development mode (additional debugging info)"))
-    .action((unparsedArgs, unparsedOptions) => {
-    const versionResult = argsSchema.safeParse(unparsedArgs);
-    const optionsResult = optionsSchema.safeParse(unparsedOptions);
-    if (!versionResult.success) {
-        process.stderr.write("\nInvalid version argument:\n");
-        versionResult.error.errors.forEach((err) => {
-            process.stderr.write(`- ${err.message}\n`);
-        });
-        process.exit(1);
-    }
-    if (!optionsResult.success) {
-        process.stderr.write("\nInvalid options:\n");
-        optionsResult.error.errors.forEach((err) => {
-            process.stderr.write(`- ${err.path.map((p) => String(p).replace(/[A-Z]/g, (m) => `-${m.toLowerCase()}`)).join(".")}: ${err.message}\n`);
-        });
-        process.exit(1);
-    }
-    const version = versionResult.data;
-    const options = optionsResult.data;
-    const actor = createActor(publishVersionMachine, {
-        input: {
-            major: version ? Number(version.split(".")[0]) : undefined,
-            minor: version ? Number(version.split(".")[1]) : undefined,
-        },
-    });
-    if (options.dev) {
-        actor.subscribe((state) => {
-            console.log("state:", state.value);
-        });
-    }
-    actor.start();
-});