@automate.ax/catalog 0.56.1 → 0.57.0

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { airtableService, anthropicService, apolloService, asanaService, brevoService, cerebrasService, cloudflareService, cohereService, deepinfraService, deepseekService, firecrawlService, fireworksService, getIntegrationService, githubService, googleGenaiService, googleService, groqService, huggingfaceService, integrationCatalog, linearService, microsoftService, millionverifierService, mistralService, openaiService, openrouterService, perplexityService, postgresService, resendService, scrapflyService, slackService, tidycalService, togetheraiService, trelloService, vercelAiGatewayService, vercelService, whatsappService, xaiService, type IntegrationServiceId, } from "./catalog.js";
-export { defineIntegrationCatalog, defineIntegrationService, scope, type IntegrationAccountConnectionOption, type IntegrationAccountRequirement, type IntegrationConnectionDefinition, type IntegrationFormField, type IntegrationScopeRequirement, type IntegrationServiceDefinition, type ScopeRequirementGroup, type TriggerDefinition, type TriggerPresentation, type TriggerPresentationContext, type TriggerPresentationDetail, type TriggerPresentationValue, } from "./types.js";
-export { getHttpTriggerEndpoint, getHttpTriggerEndpointKey, getTriggerDefinition, getTriggerName, getTriggerPresentation, triggerCatalog, triggerDefinitions, type HttpTriggerEndpointOptions, type HttpTriggerScope, type TriggerType, } from "./triggers/index.js";
+export { defineIntegrationCatalog, defineIntegrationService, integrationScope, type IntegrationAccountConnectionOption, type IntegrationAccountRequirement, type IntegrationConnectionDefinition, type IntegrationFormField, type IntegrationScopeRequirement, type IntegrationServiceDefinition, type ScopeRequirementGroup, type TriggerDefinition, type TriggerPresentation, type TriggerPresentationContext, type TriggerPresentationDetail, type TriggerScopePresentation, type TriggerPresentationValue, } from "./types.js";
+export { getHttpTriggerEndpoint, getHttpTriggerEndpointKey, getTriggerDefinition, getTriggerName, getTriggerPresentation, isTriggerVisible, triggerCatalog, triggerDefinitions, type HttpTriggerEndpointOptions, type HttpTriggerScope, type TriggerType, } from "./triggers/index.js";

package/dist/index.js

@@ -1,3 +1,3 @@
 export { airtableService, anthropicService, apolloService, asanaService, brevoService, cerebrasService, cloudflareService, cohereService, deepinfraService, deepseekService, firecrawlService, fireworksService, getIntegrationService, githubService, googleGenaiService, googleService, groqService, huggingfaceService, integrationCatalog, linearService, microsoftService, millionverifierService, mistralService, openaiService, openrouterService, perplexityService, postgresService, resendService, scrapflyService, slackService, tidycalService, togetheraiService, trelloService, vercelAiGatewayService, vercelService, whatsappService, xaiService, } from "./catalog.js";
-export { defineIntegrationCatalog, defineIntegrationService, scope, } from "./types.js";
-export { getHttpTriggerEndpoint, getHttpTriggerEndpointKey, getTriggerDefinition, getTriggerName, getTriggerPresentation, triggerCatalog, triggerDefinitions, } from "./triggers/index.js";
+export { defineIntegrationCatalog, defineIntegrationService, integrationScope, } from "./types.js";
+export { getHttpTriggerEndpoint, getHttpTriggerEndpointKey, getTriggerDefinition, getTriggerName, getTriggerPresentation, isTriggerVisible, triggerCatalog, triggerDefinitions, } from "./triggers/index.js";

package/dist/triggers/core.d.ts

@@ -18,7 +18,7 @@ export declare const coreTriggerDefinitions: {
         readonly type: "cron.tick";
     };
     readonly httpRequest: {
-        readonly getPrimary: ({ appOrigin, automationId, config, hookSlot, projectId }: import("..").TriggerPresentationContext) => {
+        readonly getPrimary: ({ appOrigin, automationId, config, hookSlot, projectId, scopePath, }: import("..").TriggerPresentationContext) => {
             copyable: true;
             value: string;
         };
@@ -34,6 +34,7 @@ export interface HttpTriggerEndpointOptions {
     hookSlot: number;
     projectId: string;
     scope: HttpTriggerScope;
+    scopePath?: readonly number[];
 }
 /**
  * Returns the public URL for one deployed HTTP trigger.

package/dist/triggers/core.js

@@ -34,7 +34,7 @@ export const coreTriggerDefinitions = {
         type: "cron.tick",
     },
     httpRequest: {
-        getPrimary: ({ appOrigin, automationId, config, hookSlot, projectId }) => ({
+        getPrimary: ({ appOrigin, automationId, config, hookSlot, projectId, scopePath, }) => ({
             copyable: true,
             value: getHttpTriggerEndpoint({
                 appOrigin,
@@ -42,6 +42,7 @@ export const coreTriggerDefinitions = {
                 hookSlot,
                 projectId,
                 scope: HTTP_PRESENTATION_CONFIG_SCHEMA.parse(config).scope,
+                scopePath,
             }),
         }),
         icon: "webhook",
@@ -67,5 +68,8 @@ export function getHttpTriggerEndpointKey(options) {
         return options.projectId;
     if (options.scope === "automation")
         return options.automationId;
-    return `${options.automationId}:${options.hookSlot}`;
+    return `${options.automationId}:${[
+        ...(options.scopePath ?? []),
+        options.hookSlot,
+    ].join(".")}`;
 }

package/dist/triggers/index.d.ts

@@ -1,4 +1,4 @@
-import type { TriggerDefinition, TriggerPresentation, TriggerPresentationContext } from "../types.js";
+import type { TriggerDefinition, TriggerPresentation, TriggerPresentationContext, TriggerScopePresentation } from "../types.js";
 export { getHttpTriggerEndpoint, getHttpTriggerEndpointKey, type HttpTriggerEndpointOptions, type HttpTriggerScope, } from "./core.js";
 /** Plain shared definitions for every public trigger type. */
 export declare const triggerDefinitions: {
@@ -1067,7 +1067,7 @@ export declare const triggerDefinitions: {
         readonly type: "cron.tick";
     };
     readonly httpRequest: {
-        readonly getPrimary: ({ appOrigin, automationId, config, hookSlot, projectId }: TriggerPresentationContext) => {
+        readonly getPrimary: ({ appOrigin, automationId, config, hookSlot, projectId, scopePath, }: TriggerPresentationContext) => {
             copyable: true;
             value: string;
         };
@@ -1549,7 +1549,7 @@ export declare const triggerCatalog: ({
     type: "cron.tick";
 } | {
     name: string;
-    getPrimary: ({ appOrigin, automationId, config, hookSlot, projectId }: TriggerPresentationContext) => {
+    getPrimary: ({ appOrigin, automationId, config, hookSlot, projectId, scopePath, }: TriggerPresentationContext) => {
         copyable: true;
         value: string;
     };
@@ -2612,3 +2612,10 @@ export declare function getTriggerName(type: string): string;
 export declare function getTriggerPresentation(context: TriggerPresentationContext & {
     eventType: string;
 }): TriggerPresentation;
+/**
+ * Returns whether a trigger should be shown outside its enclosing scopes.
+ *
+ * @param scopePath - The trigger's enclosing scope path.
+ * @param scopes - The automation's planned scope presentation.
+ */
+export declare function isTriggerVisible(scopePath: readonly number[], scopes: readonly TriggerScopePresentation[]): boolean;

package/dist/triggers/index.js

@@ -73,6 +73,17 @@ export function getTriggerPresentation(context) {
         type: context.eventType,
     };
 }
+/**
+ * Returns whether a trigger should be shown outside its enclosing scopes.
+ *
+ * @param scopePath - The trigger's enclosing scope path.
+ * @param scopes - The automation's planned scope presentation.
+ */
+export function isTriggerVisible(scopePath, scopes) {
+    return !scopes.some((scope) => scope.presentation !== "expanded" &&
+        scope.path.length <= scopePath.length &&
+        scope.path.every((segment, index) => scopePath[index] === segment));
+}
 /**
  * Infers presentation copy from a trigger's stable event type.
  *

package/dist/types.d.ts

@@ -50,7 +50,7 @@ export interface ScopeRequirementGroup {
     type: "and" | "or";
 }
 /** Combinators for declaring recursive integration scope requirements. */
-export declare const scope: {
+export declare const integrationScope: {
     /**
      * Requires every scope or nested group.
      *
@@ -107,6 +107,12 @@ export interface TriggerPresentationContext {
     config: unknown;
     hookSlot: number;
     projectId: string;
+    scopePath?: readonly number[];
+}
+/** Presentation metadata for one nested automation scope. */
+export interface TriggerScopePresentation {
+    path: readonly number[];
+    presentation: "collapsed" | "expanded" | "hidden";
 }
 /** One user-facing value in a configured trigger's presentation. */
 export interface TriggerPresentationValue {

package/dist/types.js

@@ -1,5 +1,5 @@
 /** Combinators for declaring recursive integration scope requirements. */
-export const scope = {
+export const integrationScope = {
     /**
      * Requires every scope or nested group.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/catalog",
-  "version": "0.56.1",
+  "version": "0.57.0",
   "description": "Shared integration service and trigger definitions for Automate.ax.",
   "license": "MIT",
   "repository": {

package/src/index.ts

@@ -41,7 +41,7 @@ export {
 export {
   defineIntegrationCatalog,
   defineIntegrationService,
-  scope,
+  integrationScope,
   type IntegrationAccountConnectionOption,
   type IntegrationAccountRequirement,
   type IntegrationConnectionDefinition,
@@ -53,6 +53,7 @@ export {
   type TriggerPresentation,
   type TriggerPresentationContext,
   type TriggerPresentationDetail,
+  type TriggerScopePresentation,
   type TriggerPresentationValue,
 } from "./types"
 export {
@@ -61,6 +62,7 @@ export {
   getTriggerDefinition,
   getTriggerName,
   getTriggerPresentation,
+  isTriggerVisible,
   triggerCatalog,
   triggerDefinitions,
   type HttpTriggerEndpointOptions,

package/src/triggers/core.ts

@@ -38,7 +38,14 @@ export const coreTriggerDefinitions = {
     type: "cron.tick",
   },
   httpRequest: {
-    getPrimary: ({ appOrigin, automationId, config, hookSlot, projectId }) => ({
+    getPrimary: ({
+      appOrigin,
+      automationId,
+      config,
+      hookSlot,
+      projectId,
+      scopePath,
+    }) => ({
       copyable: true,
       value: getHttpTriggerEndpoint({
         appOrigin,
@@ -46,6 +53,7 @@ export const coreTriggerDefinitions = {
         hookSlot,
         projectId,
         scope: HTTP_PRESENTATION_CONFIG_SCHEMA.parse(config).scope,
+        scopePath,
       }),
     }),
     icon: "webhook",
@@ -62,6 +70,7 @@ export interface HttpTriggerEndpointOptions {
   hookSlot: number
   projectId: string
   scope: HttpTriggerScope
+  scopePath?: readonly number[]
 }
 
 /**
@@ -86,5 +95,8 @@ export function getHttpTriggerEndpointKey(
 ) {
   if (options.scope === "project") return options.projectId
   if (options.scope === "automation") return options.automationId
-  return `${options.automationId}:${options.hookSlot}`
+  return `${options.automationId}:${[
+    ...(options.scopePath ?? []),
+    options.hookSlot,
+  ].join(".")}`
 }

package/src/triggers/index.ts

@@ -16,6 +16,7 @@ import type {
   TriggerDefinition,
   TriggerPresentation,
   TriggerPresentationContext,
+  TriggerScopePresentation,
 } from "../types"
 
 export {
@@ -101,6 +102,24 @@ export function getTriggerPresentation(
   }
 }
 
+/**
+ * Returns whether a trigger should be shown outside its enclosing scopes.
+ *
+ * @param scopePath - The trigger's enclosing scope path.
+ * @param scopes - The automation's planned scope presentation.
+ */
+export function isTriggerVisible(
+  scopePath: readonly number[],
+  scopes: readonly TriggerScopePresentation[],
+) {
+  return !scopes.some(
+    (scope) =>
+      scope.presentation !== "expanded" &&
+      scope.path.length <= scopePath.length &&
+      scope.path.every((segment, index) => scopePath[index] === segment),
+  )
+}
+
 /**
  * Infers presentation copy from a trigger's stable event type.
  *

package/src/types.ts

@@ -64,7 +64,7 @@ export interface ScopeRequirementGroup {
 }
 
 /** Combinators for declaring recursive integration scope requirements. */
-export const scope = {
+export const integrationScope = {
   /**
    * Requires every scope or nested group.
    *
@@ -139,6 +139,13 @@ export interface TriggerPresentationContext {
   config: unknown
   hookSlot: number
   projectId: string
+  scopePath?: readonly number[]
+}
+
+/** Presentation metadata for one nested automation scope. */
+export interface TriggerScopePresentation {
+  path: readonly number[]
+  presentation: "collapsed" | "expanded" | "hidden"
 }
 
 /** One user-facing value in a configured trigger's presentation. */