@archastro/sdk 0.7.0 → 0.9.0

package/dist/v1.js

@@ -1,6 +1,6 @@
-// Copyright (c) 2026 ArchAstro Inc. All Rights Reserved.
+// Copyright (c) 2026 ArchAstro Inc. Licensed under the MIT License.
 // This file is auto-generated by @archastro/sdk-generator. Do not edit.
-// Content hash: f0203c0f2a78
+// Content hash: 5ca888214c05
 import { ActivityFeedResource } from "./v1/resources/activity_feed.js";
 import { AgentComputerResource } from "./v1/resources/agent_computers.js";
 import { AgentEnvVarResource } from "./v1/resources/agent_env_vars.js";
@@ -19,17 +19,21 @@ import { AutomationResource } from "./v1/resources/automations.js";
 import { BugReportResource } from "./v1/resources/bug_reports.js";
 import { ConfigResource } from "./v1/resources/config.js";
 import { CustomObjectResource } from "./v1/resources/custom_objects.js";
+import { ExtractionResource } from "./v1/resources/extractions.js";
 import { FileResource } from "./v1/resources/files.js";
 import { InstallationSourceResource } from "./v1/resources/installation_sources.js";
 import { InviteResource } from "./v1/resources/invites.js";
 import { KnowledgeDocumentResource } from "./v1/resources/knowledge_documents.js";
+import { KnowledgeIngestionResource } from "./v1/resources/knowledge_ingestions.js";
 import { KnowledgeSourceResource } from "./v1/resources/knowledge_sources.js";
 import { KvResource } from "./v1/resources/kv.js";
 import { NotificationPreferenceResource } from "./v1/resources/notification_preferences.js";
 import { NotificationResource } from "./v1/resources/notifications.js";
+import { OauthResource } from "./v1/resources/oauth.js";
 import { OrgResource } from "./v1/resources/orgs.js";
 import { SlackChannelBindingResource } from "./v1/resources/slack_channel_bindings.js";
 import { SolutionCategoryResource } from "./v1/resources/solution_categories.js";
+import { SolutionInstanceResource } from "./v1/resources/solution_instances.js";
 import { SolutionTagResource } from "./v1/resources/solution_tags.js";
 import { SolutionResource } from "./v1/resources/solutions.js";
 import { TeamMembershipResource } from "./v1/resources/team_memberships.js";
@@ -37,6 +41,7 @@ import { TeamResource } from "./v1/resources/teams.js";
 import { ThreadMessageResource } from "./v1/resources/thread_messages.js";
 import { ThreadResource } from "./v1/resources/threads.js";
 import { UserResource } from "./v1/resources/users.js";
+import { WorkItemResource } from "./v1/resources/work_items.js";
 export class V1 {
     activity_feed;
     agent_computers;
@@ -55,10 +60,12 @@ export class V1 {
     bug_reports;
     config;
     custom_objects;
+    extractions;
     files;
     installation_sources;
     invites;
     knowledge_documents;
+    knowledge_ingestions;
     knowledge_sources;
     kv;
     notification_preferences;
@@ -66,6 +73,7 @@ export class V1 {
     orgs;
     slack_channel_bindings;
     solution_categories;
+    solution_instances;
     solution_tags;
     solutions;
     team_memberships;
@@ -73,7 +81,9 @@ export class V1 {
     thread_messages;
     threads;
     users;
+    work_items;
     ai;
+    oauth;
     constructor(http) {
         this.activity_feed = new ActivityFeedResource(http);
         this.agent_computers = new AgentComputerResource(http);
@@ -92,10 +102,12 @@ export class V1 {
         this.bug_reports = new BugReportResource(http);
         this.config = new ConfigResource(http);
         this.custom_objects = new CustomObjectResource(http);
+        this.extractions = new ExtractionResource(http);
         this.files = new FileResource(http);
         this.installation_sources = new InstallationSourceResource(http);
         this.invites = new InviteResource(http);
         this.knowledge_documents = new KnowledgeDocumentResource(http);
+        this.knowledge_ingestions = new KnowledgeIngestionResource(http);
         this.knowledge_sources = new KnowledgeSourceResource(http);
         this.kv = new KvResource(http);
         this.notification_preferences = new NotificationPreferenceResource(http);
@@ -103,6 +115,7 @@ export class V1 {
         this.orgs = new OrgResource(http);
         this.slack_channel_bindings = new SlackChannelBindingResource(http);
         this.solution_categories = new SolutionCategoryResource(http);
+        this.solution_instances = new SolutionInstanceResource(http);
         this.solution_tags = new SolutionTagResource(http);
         this.solutions = new SolutionResource(http);
         this.team_memberships = new TeamMembershipResource(http);
@@ -110,7 +123,9 @@ export class V1 {
         this.thread_messages = new ThreadMessageResource(http);
         this.threads = new ThreadResource(http);
         this.users = new UserResource(http);
+        this.work_items = new WorkItemResource(http);
         this.ai = new AiResource(http);
+        this.oauth = new OauthResource(http);
     }
 }
 //# sourceMappingURL=v1.js.map

package/dist/v1.js.map

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

package/docs/custom-object-collaboration.md

@@ -0,0 +1,248 @@
+---
+title: Custom-object collaboration
+group: Guides
+---
+
+# Custom-object collaboration
+
+Custom objects combine persisted JSON fields with a realtime channel. Use nested
+maps for independently edited records so one user's change does not replace
+another user's unrelated work.
+
+## Same-origin browser client
+
+When a backend owns the platform credential in an HttpOnly session cookie,
+construct one client for the authenticated browser session and point both HTTP
+and WebSocket traffic at that backend:
+
+```ts
+import {
+  PlatformClient,
+  withCustomObjectSubscriptions,
+} from "@archastro/sdk";
+
+const RealtimePlatformClient = PlatformClient.extend(
+  withCustomObjectSubscriptions,
+);
+
+export const archAstro = new RealtimePlatformClient({
+  baseUrl: window.location.origin,
+  pathPrefix: "/api/archastro/platform",
+  credentials: "include",
+});
+```
+
+`extend` uses the TypeScript class-expression mixin pattern. It returns a new
+client class, so generated resources and static factories remain available and
+the compiler infers `customObjectSubscriptions` on its instances. Extensions
+can be chained by calling `extend` again on the returned class.
+
+The SDK sends HTTP requests to the configured `pathPrefix`. WebSocket
+subscriptions connect to `socketPath`; the browser includes same-origin cookies
+during the upgrade. Access and refresh tokens therefore remain unavailable to
+browser JavaScript. The backend must authenticate the cookie before proxying
+HTTP requests or accepting the WebSocket upgrade.
+
+The extension derives `/api/archastro/platform/socket` from the configured
+`pathPrefix`. For a nonstandard route, pass
+`customObjectSubscriptionsExtension({ socketPath })` to `extend` instead.
+
+## List and create team-owned objects
+
+App scope comes from the authenticated session, so these calls do not take an
+app ID. Team ownership is explicit:
+
+```ts
+const page = await archAstro.custom_objects.list({
+  type: "archcode-diagram",
+  team: [teamId],
+  pageSize: 100,
+});
+
+const created = await archAstro.custom_objects.create({
+  type: "archcode-diagram",
+  team: teamId,
+  fields: {
+    diagram_key: crypto.randomUUID(),
+    repository: "firstlanding",
+    title: "Request path",
+    elements_by_id: {},
+    files_by_id: {},
+    comments_by_id: {},
+    metadata: {},
+  },
+});
+```
+
+## Subscribe, update, save, and close
+
+```ts
+import { z } from "zod";
+import type {
+  CustomObjectConnectionState,
+  CustomObjectSubscription,
+} from "@archastro/sdk";
+
+const DiagramFields = z.object({
+  diagram_key: z.string(),
+  repository: z.string(),
+  title: z.string(),
+  elements_by_id: z.record(z.record(z.unknown())),
+  files_by_id: z.record(z.record(z.unknown())),
+  comments_by_id: z.record(z.record(z.unknown())),
+  metadata: z.record(z.unknown()),
+});
+
+type DiagramFields = z.infer<typeof DiagramFields>;
+
+let applyingRemote = false;
+let state: CustomObjectConnectionState = "connecting";
+
+const subscription: CustomObjectSubscription<DiagramFields> =
+  archAstro.customObjectSubscriptions.subscribe({
+    objectId: created.id,
+    connectionId: perTabConnectionId,
+    fieldsSchema: DiagramFields,
+
+    // Called for the initial join and again after every reconnect. A reconnect
+    // snapshot is authoritative and arrives before queued idempotent patches
+    // are replayed.
+    onSnapshot(snapshot) {
+      setReadonly(snapshot.readonly === true);
+      applyingRemote = true;
+      try {
+        replaceMaterializedDocument(snapshot.fields);
+      } finally {
+        applyingRemote = false;
+      }
+    },
+
+    // object_updated can contain a partial update or a complete fields map.
+    // Compare canonical content before applying it.
+    onUpdate(update) {
+      if (alreadyMaterialized(update.fields)) return;
+      applyingRemote = true;
+      try {
+        mergeMaterializedDocument(update.fields);
+      } finally {
+        applyingRemote = false;
+      }
+    },
+
+    onPresence(collaborator) {
+      renderCollaborator(collaborator);
+    },
+
+    onPresenceLeave(collaborator) {
+      removeCollaborator(collaborator.connectionId);
+    },
+
+    onStateChange(nextState) {
+      state = nextState;
+      renderConnectionState(nextState);
+    },
+
+    onError(error) {
+      reportCollaborationError(error);
+    },
+  });
+
+// Nested map assignment: safe to replay because it is idempotent.
+await subscription.update({
+  elements_by_id: {
+    "element-42": {
+      x: 420,
+      y: 180,
+      updated_by: currentUser.id,
+    },
+  },
+});
+
+// Presence is ephemeral and is never written into custom-object fields.
+await subscription.updatePresence({
+  cursor: { x: 420, y: 180 },
+  selectedElementIds: ["element-42"],
+  activity: "active",
+});
+
+await subscription.save();
+subscription.close();
+```
+
+Connection states have these meanings:
+
+- `connecting`: the initial transport and channel join are in progress.
+- `live`: the current snapshot is materialized and queued patches are acknowledged.
+- `reconnecting`: transport recovery is in progress.
+- `offline`: the browser reports that network connectivity is unavailable.
+- `unauthorized`: authentication or authorization failed. This state is terminal.
+- `closed`: the caller closed the subscription or the object no longer exists.
+
+Each snapshot also preserves the server's `readonly` flag and resolved
+`connectionId`. Initial collaborators from the join response are delivered
+through `onPresence` before the subscription becomes `live`.
+
+`close()` removes channel listeners, stops reconnect attempts, rejects pending
+queued updates, leaves the channel when possible, and closes the socket.
+
+## React effect cleanup
+
+```tsx
+useEffect(() => {
+  const subscription =
+    archAstro.customObjectSubscriptions.subscribe<DiagramFields>({
+      objectId: diagramId,
+      fieldsSchema: DiagramFields,
+      onSnapshot: setDocumentFromSnapshot,
+      onUpdate: mergeRemoteUpdate,
+      onPresence: upsertCollaborator,
+      onPresenceLeave: removeCollaborator,
+      onStateChange: setConnectionState,
+      onError: setCollaborationError,
+    });
+
+  return () => {
+    subscription.close();
+  };
+}, [diagramId]);
+```
+
+Create one subscription per mounted document. Always close the old subscription
+before subscribing to another object; this prevents duplicate listeners after
+navigation or React effect re-runs.
+
+## Retry and convergence rules
+
+Plain nested-map assignments sent through `subscription.update()` are
+idempotent. While disconnected, the SDK compacts superseded nested assignments.
+After reconnect it:
+
+1. authenticates and joins again;
+2. delivers the authoritative current snapshot;
+3. replays compacted idempotent assignments;
+4. waits for acknowledgements;
+5. transitions to `live`.
+
+Do not blindly retry array append/prepend/remove operations, creates without a
+stable upsert key, deletes, or another mutation whose first acknowledgement may
+have been lost. HTTP reads are safe for the application to retry with bounded
+backoff. Do not retry authentication, authorization, or validation errors.
+
+Nested maps are preferable to one shared array for collaborative documents.
+Updating `elements_by_id.element-42.x` leaves other elements and other properties
+untouched, while replacing an array makes the entire collection one conflict
+unit.
+
+Presence remains ephemeral because cursors, selections, idle state, and browser
+connection IDs have no durable document meaning. Persisting them would create
+stale collaborators and unnecessary custom-object writes.
+
+Snapshot and remote-update handlers must use an internal guard, as shown above,
+so applying remote state does not produce a local outgoing mutation. Also compare
+canonical values rather than timestamps alone.
+
+If access is revoked, the subscription reports an authentication or
+authorization error, transitions to `unauthorized`, stops reconnecting, and
+rejects further durable updates. The application should disable editing while
+leaving navigation and export of already authorized local data accessible as
+appropriate.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archastro/sdk",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "TypeScript SDK for the ArchAstro Platform API (Node, browser, React Native)",
   "type": "module",
   "main": "dist/index.js",
@@ -15,9 +15,10 @@
     "build": "tsc",
     "clean": "rm -rf dist",
     "docs": "typedoc --options typedoc.json",
-    "lint": "tsc --noEmit",
+    "lint": "tsc --noEmit && npm run test:types",
     "prepublishOnly": "npm run build",
     "test": "vitest run",
+    "test:types": "npm run build && tsc -p tsconfig.type-tests.json",
     "test:contract": "vitest run --config __tests__/contract/vitest.contract.config.ts"
   },
   "license": "MIT",