@automate.ax/api-contract 0.6.0 → 0.7.1

package/README.md

@@ -1,5 +1,6 @@
 # `@automate.ax/api-contract`
 
-Public oRPC contract shared by the Automate.ax API and typed client.
+Shared oRPC procedure contracts for the Automate.ax API. The public contract
+used by `@automate.ax/client` excludes first-party and runtime procedures.
 
 Most applications should install `@automate.ax/client` instead.

package/dist/deployment.d.ts

@@ -12,11 +12,16 @@ export declare const deploymentTriggerInfoSchema: z.ZodObject<{
 export type DeploymentTriggerInfo = z.infer<typeof deploymentTriggerInfoSchema>;
 export declare const deploymentContract: {
     create: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
-        projectId: z.ZodString;
-        automations: z.ZodArray<z.ZodObject<{
-            body: z.ZodCustom<Blob, Blob>;
+        artifact: z.ZodCustom<Blob, Blob>;
+        manifest: z.ZodArray<z.ZodObject<{
+            entrypoint: z.ZodString;
             identityKey: z.ZodString;
         }, z.core.$strip>>;
+        mode: z.ZodEnum<{
+            reconcile: "reconcile";
+            upsert: "upsert";
+        }>;
+        projectId: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodString;
     }, z.core.$strip>, Record<never, never>, Record<never, never>>;
@@ -51,9 +56,8 @@ export declare const deploymentContract: {
             planning: "planning";
             awaiting_authorization: "awaiting_authorization";
             configuring: "configuring";
-            active: "active";
-            inactive: "inactive";
-            superseded: "superseded";
+            publishing: "publishing";
+            succeeded: "succeeded";
             failed: "failed";
         }>;
     }, z.core.$strip>, Record<never, never>, Record<never, never>>;

package/dist/deployment.js

@@ -15,14 +15,40 @@ export const deploymentTriggerInfoSchema = z.object({
 export const deploymentContract = {
     create: oc
         .input(z.object({
-        projectId: z.string(),
-        automations: z
+        artifact: z.instanceof(Blob),
+        manifest: z
             .object({
-            body: z.instanceof(Blob),
+            entrypoint: z.string().min(1),
             identityKey: z.string().min(1),
         })
             .array()
-            .min(1, "Deployment must include at least one automation."),
+            .min(1, "Deployment must include at least one automation.")
+            .superRefine((manifest, context) => {
+            const identityKeys = new Set();
+            for (const [index, entry] of manifest.entries()) {
+                if (identityKeys.has(entry.identityKey)) {
+                    context.addIssue({
+                        code: "custom",
+                        message: "Automation identity keys must be unique.",
+                        path: [index, "identityKey"],
+                    });
+                }
+                identityKeys.add(entry.identityKey);
+                if (entry.entrypoint.includes("\\") ||
+                    entry.entrypoint.startsWith("/") ||
+                    entry.entrypoint
+                        .split("/")
+                        .some((segment) => segment === "" || segment === "." || segment === "..")) {
+                    context.addIssue({
+                        code: "custom",
+                        message: "Entrypoint must be a safe relative POSIX path.",
+                        path: [index, "entrypoint"],
+                    });
+                }
+            }
+        }),
+        mode: z.enum(["reconcile", "upsert"]),
+        projectId: z.string(),
     }))
         .output(z.object({ id: z.string() })),
     get: oc
@@ -55,9 +81,8 @@ export const deploymentContract = {
             "planning",
             "awaiting_authorization",
             "configuring",
-            "active",
-            "inactive",
-            "superseded",
+            "publishing",
+            "succeeded",
             "failed",
         ]),
     })),

package/dist/events/google-calendar.d.ts

@@ -0,0 +1,4 @@
+import { z } from "zod";
+export declare const googleCalendarEventsContract: {
+    googleCalendarPush: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodVoid, z.ZodVoid, Record<never, never>, Record<never, never>>;
+};

package/dist/events/google-calendar.js

@@ -0,0 +1,16 @@
+import { oc } from "@orpc/contract";
+import { z } from "zod";
+export const googleCalendarEventsContract = {
+    googleCalendarPush: oc
+        .route({
+        method: "POST",
+        path: "/events/google-calendar",
+        operationId: "receiveGoogleCalendarPush",
+        summary: "Receive a Google Calendar push notification",
+        description: "Receives header-only Google Calendar resource-change notifications.",
+        tags: ["Events"],
+        successStatus: 204,
+    })
+        .input(z.void())
+        .output(z.void()),
+};

package/dist/events/google-forms.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+export declare const googleFormsEventsContract: {
+    googleFormsPush: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        message: z.ZodObject<{
+            attributes: z.ZodObject<{
+                eventType: z.ZodEnum<{
+                    SCHEMA: "SCHEMA";
+                    RESPONSES: "RESPONSES";
+                }>;
+                formId: z.ZodString;
+                watchId: z.ZodString;
+            }, z.core.$strip>;
+            messageId: z.ZodString;
+            publishTime: z.ZodISODateTime;
+        }, z.core.$strip>;
+        subscription: z.ZodLiteral<"projects/opkitty/subscriptions/automate-ax-google-forms-push">;
+    }, z.core.$strip>, z.ZodVoid, Record<never, never>, Record<never, never>>;
+};

package/dist/events/google-forms.js

@@ -0,0 +1,32 @@
+import { oc } from "@orpc/contract";
+import { z } from "zod";
+export const googleFormsEventsContract = {
+    googleFormsPush: oc
+        .route({
+        method: "POST",
+        path: "/events/google-forms",
+        operationId: "receiveGoogleFormsPush",
+        summary: "Receive a Google Forms push notification",
+        description: "Receives and authenticates Google Forms notifications delivered by Google Cloud Pub/Sub.",
+        tags: ["Events"],
+        successStatus: 204,
+    })
+        .input(z.object({
+        /** Pub/Sub message containing Google Forms notification attributes. */
+        message: z.object({
+            /** Provider routing fields for the watched form. */
+            attributes: z.object({
+                eventType: z.enum(["SCHEMA", "RESPONSES"]),
+                formId: z.string().min(1),
+                watchId: z.string().min(1),
+            }),
+            /** Provider-assigned identifier used to deduplicate delivery. */
+            messageId: z.string().min(1),
+            /** RFC 3339 time at which Pub/Sub published the notification. */
+            publishTime: z.iso.datetime({ offset: true }),
+        }),
+        /** Pub/Sub subscription that delivered the message. */
+        subscription: z.literal("projects/opkitty/subscriptions/automate-ax-google-forms-push"),
+    }))
+        .output(z.void()),
+};

package/dist/events/index.d.ts

@@ -6,4 +6,20 @@ export declare const eventsContract: {
         }, import("zod/v4/core").$strip>;
         subscription: import("zod").ZodLiteral<"projects/opkitty/subscriptions/automate-ax-gmail-push">;
     }, import("zod/v4/core").$strip>, import("zod").ZodVoid, Record<never, never>, Record<never, never>>;
+    googleFormsPush: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
+        message: import("zod").ZodObject<{
+            attributes: import("zod").ZodObject<{
+                eventType: import("zod").ZodEnum<{
+                    SCHEMA: "SCHEMA";
+                    RESPONSES: "RESPONSES";
+                }>;
+                formId: import("zod").ZodString;
+                watchId: import("zod").ZodString;
+            }, import("zod/v4/core").$strip>;
+            messageId: import("zod").ZodString;
+            publishTime: import("zod").ZodISODateTime;
+        }, import("zod/v4/core").$strip>;
+        subscription: import("zod").ZodLiteral<"projects/opkitty/subscriptions/automate-ax-google-forms-push">;
+    }, import("zod/v4/core").$strip>, import("zod").ZodVoid, Record<never, never>, Record<never, never>>;
+    googleCalendarPush: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodVoid, import("zod").ZodVoid, Record<never, never>, Record<never, never>>;
 };

package/dist/events/index.js

@@ -1,4 +1,8 @@
+import { googleCalendarEventsContract } from "./google-calendar.js";
+import { googleFormsEventsContract } from "./google-forms.js";
 import { gmailEventsContract } from "./gmail.js";
 export const eventsContract = {
+    ...googleCalendarEventsContract,
+    ...googleFormsEventsContract,
     ...gmailEventsContract,
 };