@finalai/computers 0.1.0

package/README.md

@@ -0,0 +1,16 @@
+# @finalai/computers
+
+Client for the Final Computers public `/v1` API, authenticated with an API key.
+
+```ts
+import { createComputerClient, orThrow } from '@finalai/computers';
+const client = createComputerClient({
+  baseUrl: 'https://computer-api.final.ai',
+  auth: { apiKey: 'your-api-key' },
+});
+const computers = orThrow(await client.listComputers());
+```
+
+Calls return `ResultIface<T>`. Transport configuration accepts injected `fetch`, a
+request timeout, and cancellation. `/transport` exposes reusable transport/client
+adapter seams. Node 26 is required for file operations that use Buffer.

package/dist/modules/browser-access.d.mts

@@ -0,0 +1,18 @@
+import * as z from 'zod';
+export declare const computerBrowserAccessSchema: z.ZodObject<{
+    tokenId: z.ZodString;
+    url: z.ZodString;
+    token: z.ZodString;
+    expiresAt: z.ZodString;
+    returnTo: z.ZodString;
+}, z.core.$strip>;
+export type ComputerBrowserAccessIface = z.infer<typeof computerBrowserAccessSchema>;
+export interface ComputerBrowserAccessOptionsIface {
+    port: number;
+    /** Local application path, including query parameters. Never an external URL. */
+    returnTo?: string;
+}
+export declare const computerBrowserAccessRequestSchema: z.ZodObject<{
+    port: z.ZodNumber;
+    returnTo: z.ZodDefault<z.ZodString>;
+}, z.core.$strict>;

package/dist/modules/browser-access.mjs

@@ -0,0 +1,22 @@
+import * as z from "zod";
+const computerBrowserAccessSchema = z.object({
+  tokenId: z.string(),
+  url: z.string().url(),
+  token: z.string(),
+  expiresAt: z.string(),
+  returnTo: z.string()
+});
+const computerBrowserAccessRequestSchema = z.strictObject({
+  port: z.number().int().min(3e3).max(9999),
+  returnTo: z.string().max(4096).default("/").refine(
+    (path) => path.startsWith("/") && !path.startsWith("//") && !Array.from(path).some(
+      (character) => character === "\\" || character.charCodeAt(0) < 32 || character.charCodeAt(0) === 127
+    ),
+    "returnTo must be a local application path"
+  )
+});
+export {
+  computerBrowserAccessRequestSchema,
+  computerBrowserAccessSchema
+};
+//# sourceMappingURL=browser-access.mjs.map

package/dist/modules/browser-access.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/browser-access.ts"],
+  "sourcesContent": ["import * as z from 'zod';\n\nexport const computerBrowserAccessSchema = z.object({\n  tokenId: z.string(),\n  url: z.string().url(),\n  token: z.string(),\n  expiresAt: z.string(),\n  returnTo: z.string(),\n});\nexport type ComputerBrowserAccessIface = z.infer<typeof computerBrowserAccessSchema>;\n\nexport interface ComputerBrowserAccessOptionsIface {\n  port: number;\n  /** Local application path, including query parameters. Never an external URL. */\n  returnTo?: string;\n}\n\nexport const computerBrowserAccessRequestSchema = z.strictObject({\n  port: z.number().int().min(3000).max(9999),\n  returnTo: z\n    .string()\n    .max(4096)\n    .default('/')\n    .refine(\n      (path) =>\n        path.startsWith('/') &&\n        !path.startsWith('//') &&\n        !Array.from(path).some(\n          (character) =>\n            character === '\\\\' || character.charCodeAt(0) < 32 || character.charCodeAt(0) === 127,\n        ),\n      'returnTo must be a local application path',\n    ),\n});\n"],
+  "mappings": "AAAA,YAAY,OAAO;AAEZ,MAAM,8BAA8B,EAAE,OAAO;AAAA,EAClD,SAAS,EAAE,OAAO;AAAA,EAClB,KAAK,EAAE,OAAO,EAAE,IAAI;AAAA,EACpB,OAAO,EAAE,OAAO;AAAA,EAChB,WAAW,EAAE,OAAO;AAAA,EACpB,UAAU,EAAE,OAAO;AACrB,CAAC;AASM,MAAM,qCAAqC,EAAE,aAAa;AAAA,EAC/D,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAI,EAAE,IAAI,IAAI;AAAA,EACzC,UAAU,EACP,OAAO,EACP,IAAI,IAAI,EACR,QAAQ,GAAG,EACX;AAAA,IACC,CAAC,SACC,KAAK,WAAW,GAAG,KACnB,CAAC,KAAK,WAAW,IAAI,KACrB,CAAC,MAAM,KAAK,IAAI,EAAE;AAAA,MAChB,CAAC,cACC,cAAc,QAAQ,UAAU,WAAW,CAAC,IAAI,MAAM,UAAU,WAAW,CAAC,MAAM;AAAA,IACtF;AAAA,IACF;AAAA,EACF;AACJ,CAAC;",
+  "names": []
+}

package/dist/modules/client.d.mts

@@ -0,0 +1,5 @@
+import { type TransportIface } from "./transport.mjs";
+import { type ComputerClientIface, type ComputerHandleIface, type ComputerInfoIface, type CreateComputerClientArgsIface } from "./types.mjs";
+export declare const createComputerHandle: (transport: TransportIface, initialInfo: ComputerInfoIface) => ComputerHandleIface;
+export declare const createComputerClientWithTransport: (transport: TransportIface) => ComputerClientIface;
+export declare const createComputerClient: (args: CreateComputerClientArgsIface) => ComputerClientIface;