@instantdb/platform 1.0.30 → 1.0.31

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@instantdb/platform",
-  "version": "1.0.30",
+  "version": "1.0.31",
   "description": "Instant's platform package for managing Instant apps.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/instantdb/instant/tree/main/client/packages/platform",
@@ -55,8 +55,9 @@
   "dependencies": {
     "@babel/parser": "^8.0.0-beta.0",
     "@babel/types": "^8.0.0-beta.0",
-    "@instantdb/core": "1.0.30",
-    "@instantdb/version": "1.0.30"
+    "@instantdb/core": "1.0.31",
+    "@instantdb/version": "1.0.31",
+    "@instantdb/webhooks": "1.0.31"
   },
   "scripts": {
     "test": "vitest",

package/src/api.ts

@@ -3,6 +3,7 @@ import {
   version as coreVersion,
   InstantRules,
   InstantSchemaDef,
+  InstantUnknownSchema,
   EntitiesDef,
   LinksDef,
   RoomsDef,
@@ -13,6 +14,7 @@ import {
   InstantDBInferredType,
   DataAttrDef,
 } from '@instantdb/core';
+import { Webhooks, type WithAuth } from '@instantdb/webhooks';
 import version from './version.ts';
 import {
   attrFwdLabel,
@@ -1850,4 +1852,30 @@ export class PlatformApi {
     }
     return this.withRetry(tokenInfo, [this.#apiURI, this.token()]);
   }
+
+  /**
+   * Returns a {@link Webhooks} instance scoped to `appId`. You don't need
+   * auth on this PlatformApi to verify signatures or process incoming
+   * deliveries — only `webhooks(appId).manager.*` requires it, and those
+   * calls are routed through {@link withRetry}, so an expired access token
+   * is transparently refreshed.
+   *
+   * Pass `schema` (e.g. from {@link apiSchemaToInstantSchemaDef}) for typed
+   * handler records and typed `etypes` on `manager.create`/`update`.
+   */
+  webhooks<
+    Schema extends InstantSchemaDef<any, any, any> = InstantUnknownSchema,
+  >(appId: string, opts?: { schema?: Schema }): Webhooks<Schema> {
+    const withAuth: WithAuth = (operation) =>
+      this.withRetry(
+        (_apiURI: string, token: string) => operation(token),
+        [this.#apiURI, this.token()],
+      );
+    return new Webhooks<Schema>({
+      appId,
+      apiURI: this.#apiURI,
+      schema: opts?.schema,
+      withAuth,
+    });
+  }
 }

package/src/index.ts

@@ -27,6 +27,27 @@ import { ProgressPromise } from './ProgressPromise.ts';
 import { i, type InstantRules } from '@instantdb/core';
 import { exchangeCodeForToken, exchangeRefreshToken } from './serverOAuth.ts';
 import { clerkDomainFromPublishableKey } from './clerk.ts';
+import {
+  Webhooks,
+  type WebhookAction,
+  type WebhookStatus,
+  type WebhookEventStatus,
+  type WebhookInfo,
+  type WebhookAttempt,
+  type WebhookEventInfo,
+  type WebhookEventsPage,
+  type WebhookBody,
+  type WebhookEntity,
+  type WebhookPayload,
+  type WebhookPayloadRecord,
+  type WebhookPayloadRecordFor,
+  type WebhookHandlerFn,
+  type WebhookHandlers,
+  type WebhookHelpers,
+  type CreateWebhookParams,
+  type UpdateWebhookParams,
+  WebhooksManager,
+} from '@instantdb/webhooks';
 
 export {
   type InstantAPIPlatformSchema,
@@ -52,6 +73,25 @@ export {
   exchangeRefreshToken,
   clerkDomainFromPublishableKey,
   i,
+  Webhooks,
+  WebhooksManager,
+  type WebhookAction,
+  type WebhookStatus,
+  type WebhookEventStatus,
+  type WebhookInfo,
+  type WebhookAttempt,
+  type WebhookEventInfo,
+  type WebhookEventsPage,
+  type WebhookBody,
+  type WebhookEntity,
+  type WebhookPayload,
+  type WebhookPayloadRecord,
+  type WebhookPayloadRecordFor,
+  type WebhookHandlerFn,
+  type WebhookHandlers,
+  type WebhookHelpers,
+  type CreateWebhookParams,
+  type UpdateWebhookParams,
 };
 
 export {