@hibira-io/piece-hibira 0.1.1 → 0.3.0

package/README.md

@@ -30,6 +30,8 @@ The connection is checked with a signed request when you save it.
 - **List Occupied Channels**, **Get Channel**, **Get Users in Presence Channel** (pages through `presence-large-` channels).
 - **Disconnect User**: close every connection of a signed-in user.
 - **Send Push Notification to Interests**, **Send Push Notification to Users**, **Delete Push User**.
+- **Request Approval**, **Get Approval**: ask a person to approve or choose (2 to 4 choices, the first approves) through a Hibira-hosted answer link, optionally delivered by push or announced on a channel for the `@hibira-io/approvals` inbox. Request Approval can wait up to 9 minutes for the answer and returns `status` (`approved`, `rejected`, `pending`, `expired`) and `choice`; for longer waits, send the link and check later with Get Approval. Needs an app in a Hibira account.
+- **Get Waiting Room**, **Create or Update Waiting Room**, **Admit Visitors**, **Verify Waiting Room Pass**, **Delete Waiting Room**: run a Hibira waiting room from a flow. Open or pause a room on a schedule, admit a batch when a sale starts, or check a visitor's pass (`hibira_pass` or the `hibira_wr_<room>` cookie) from a checkout webhook; record `ticket_id` to allow one checkout per place in line. Empty fields in Create or Update keep their current values. Needs the waiting room add-on.
 
 ## Trigger
 

package/dist/src/i18n/translation.json

@@ -67,5 +67,62 @@
   "Starts the flow when a channel is occupied or vacated, a presence member joins or leaves, a client sends an event, and more.": "Starts the flow when a channel is occupied or vacated, a presence member joins or leaves, a client sends an event, and more.",
   "Events": "Events",
   "Channel Prefix": "Channel Prefix",
-  "Only events of channels whose name starts with this text, for example presence-.": "Only events of channels whose name starts with this text, for example presence-."
-}
+  "Only events of channels whose name starts with this text, for example presence-.": "Only events of channels whose name starts with this text, for example presence-.",
+  "Request Approval": "Request Approval",
+  "Asks a person to approve or choose through a Hibira-hosted answer link, and can wait for the answer.": "Asks a person to approve or choose through a Hibira-hosted answer link, and can wait for the answer.",
+  "Question": "Question",
+  "What needs a decision, as a short question (at most 200 characters), such as \"Refund order #1042 for $89?\".": "What needs a decision, as a short question (at most 200 characters), such as \"Refund order #1042 for $89?\".",
+  "Choices": "Choices",
+  "2 to 4 choices, separated by commas. The first one approves; any other rejects.": "2 to 4 choices, separated by commas. The first one approves; any other rejects.",
+  "Details": "Details",
+  "Context shown to the person: what will happen and why (at most 4000 characters).": "Context shown to the person: what will happen and why (at most 4000 characters).",
+  "Wait for Answer": "Wait for Answer",
+  "Keep the flow at this step until the person answers, for up to 9 minutes. Otherwise the step returns the link at once; check later with Get Approval.": "Keep the flow at this step until the person answers, for up to 9 minutes. Otherwise the step returns the link at once; check later with Get Approval.",
+  "Max Wait (Minutes)": "Max Wait (Minutes)",
+  "Stop waiting after this long (1 to 9) and return the request as still pending.": "Stop waiting after this long (1 to 9) and return the request as still pending.",
+  "Expires In (Minutes)": "Expires In (Minutes)",
+  "How long the link can be answered (default 60, at most 10080 = 7 days).": "How long the link can be answered (default 60, at most 10080 = 7 days).",
+  "Channel to announce the request and its answer on, for the @hibira-io/approvals inbox components.": "Channel to announce the request and its answer on, for the @hibira-io/approvals inbox components.",
+  "Push to Interests": "Push to Interests",
+  "Send the link as a push notification to these interests, separated by commas (the app needs Push enabled).": "Send the link as a push notification to these interests, separated by commas (the app needs Push enabled).",
+  "Push to User IDs": "Push to User IDs",
+  "Send the link as a push notification to these user IDs instead of interests.": "Send the link as a push notification to these user IDs instead of interests.",
+  "Get Approval": "Get Approval",
+  "Gets the status (pending, approved, rejected or expired) and answer of an approval request.": "Gets the status (pending, approved, rejected or expired) and answer of an approval request.",
+  "Approval ID": "Approval ID",
+  "The approval_id returned by Request Approval (apr_...).": "The approval_id returned by Request Approval (apr_...).",
+  "Wait (Minutes)": "Wait (Minutes)",
+  "Wait up to this long (0 to 9) for a pending request to be answered. 0 returns at once.": "Wait up to this long (0 to 9) for a pending request to be answered. 0 returns at once.",
+  "Room": "Room",
+  "The waiting room's name: 1 to 64 letters, digits, '-' or '_', such as presale.": "The waiting room's name: 1 to 64 letters, digits, '-' or '_', such as presale.",
+  "Create or Update Waiting Room": "Create or Update Waiting Room",
+  "Creates a waiting room, or changes its state, admission rate, start time or other settings.": "Creates a waiting room, or changes its state, admission rate, start time or other settings.",
+  "Admit per Minute": "Admit per Minute",
+  "How many visitors to let through each minute. Required when the room is new; leave empty to keep the current rate.": "How many visitors to let through each minute. Required when the room is new; leave empty to keep the current rate.",
+  "State": "State",
+  "Leave empty to keep the current state. A new room opens.": "Leave empty to keep the current state. A new room opens.",
+  "Open": "Open",
+  "Paused (visitors can join, nobody is admitted)": "Paused (visitors can join, nobody is admitted)",
+  "Closed (nobody can join)": "Closed (nobody can join)",
+  "Starts At": "Starts At",
+  "When admission starts. Visitors can join the queue before then.": "When admission starts. Visitors can join the queue before then.",
+  "Shown on the waiting page, at most 120 characters.": "Shown on the waiting page, at most 120 characters.",
+  "Burst": "Burst",
+  "How many visitors may be admitted at once when the queue starts moving.": "How many visitors may be admitted at once when the queue starts moving.",
+  "Pass Lifetime (Seconds)": "Pass Lifetime (Seconds)",
+  "How long an admitted visitor stays in: 60 to 86400. Default 1800.": "How long an admitted visitor stays in: 60 to 86400. Default 1800.",
+  "Return URLs": "Return URLs",
+  "Comma or newline separated https addresses visitors may be sent back to (http only for localhost). Up to 10.": "Comma or newline separated https addresses visitors may be sent back to (http only for localhost). Up to 10.",
+  "Admit Visitors": "Admit Visitors",
+  "Lets the next visitors in a waiting room through now, on top of the steady rate.": "Lets the next visitors in a waiting room through now, on top of the steady rate.",
+  "Visitors": "Visitors",
+  "How many of the next visitors to admit.": "How many of the next visitors to admit.",
+  "Verify Waiting Room Pass": "Verify Waiting Room Pass",
+  "Checks a pass a visitor brought back from the waiting room. Record ticket_id to allow one checkout per place in line.": "Checks a pass a visitor brought back from the waiting room. Record ticket_id to allow one checkout per place in line.",
+  "Pass": "Pass",
+  "The hibira_pass query parameter, or the hibira_wr_<room> cookie value.": "The hibira_pass query parameter, or the hibira_wr_<room> cookie value.",
+  "Get Waiting Room": "Get Waiting Room",
+  "Gets a waiting room's settings and how many visitors are waiting and admitted.": "Gets a waiting room's settings and how many visitors are waiting and admitted.",
+  "Delete Waiting Room": "Delete Waiting Room",
+  "Deletes a waiting room and its queue.": "Deletes a waiting room and its queue."
+}

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAWxC,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB,eAAO,MAAM,MAAM;;;;;;;GAmBjB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAkBxC,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB,eAAO,MAAM,MAAM;;;;;;;GA0BjB,CAAC"}

package/dist/src/index.js

@@ -6,13 +6,20 @@ const shared_1 = require("@activepieces/shared");
 const auth_1 = require("./lib/auth");
 Object.defineProperty(exports, "hibiraAuth", { enumerable: true, get: function () { return auth_1.hibiraAuth; } });
 const delete_push_user_1 = require("./lib/actions/delete-push-user");
+const get_approval_1 = require("./lib/actions/get-approval");
 const get_channel_1 = require("./lib/actions/get-channel");
 const get_presence_users_1 = require("./lib/actions/get-presence-users");
 const list_channels_1 = require("./lib/actions/list-channels");
 const publish_to_interests_1 = require("./lib/actions/publish-to-interests");
 const publish_to_users_1 = require("./lib/actions/publish-to-users");
+const request_approval_1 = require("./lib/actions/request-approval");
 const terminate_user_connections_1 = require("./lib/actions/terminate-user-connections");
 const trigger_event_1 = require("./lib/actions/trigger-event");
+const admit_waiting_room_1 = require("./lib/actions/admit-waiting-room");
+const delete_waiting_room_1 = require("./lib/actions/delete-waiting-room");
+const get_waiting_room_1 = require("./lib/actions/get-waiting-room");
+const update_waiting_room_1 = require("./lib/actions/update-waiting-room");
+const verify_waiting_room_pass_1 = require("./lib/actions/verify-waiting-room-pass");
 const new_webhook_event_1 = require("./lib/triggers/new-webhook-event");
 exports.hibira = (0, pieces_framework_1.createPiece)({
     displayName: 'Hibira',
@@ -31,6 +38,13 @@ exports.hibira = (0, pieces_framework_1.createPiece)({
         publish_to_interests_1.publishToInterests,
         publish_to_users_1.publishToUsers,
         delete_push_user_1.deletePushUser,
+        request_approval_1.requestApproval,
+        get_approval_1.getApproval,
+        get_waiting_room_1.getWaitingRoom,
+        update_waiting_room_1.updateWaitingRoom,
+        admit_waiting_room_1.admitWaitingRoom,
+        verify_waiting_room_pass_1.verifyWaitingRoomPass,
+        delete_waiting_room_1.deleteWaitingRoom,
     ],
     triggers: [new_webhook_event_1.newWebhookEvent],
 });

package/dist/src/lib/actions/admit-waiting-room.d.ts

@@ -0,0 +1,12 @@
+export declare const admitWaitingRoom: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").CustomAuthProperty<{
+    appId: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    key: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    secret: import("@activepieces/pieces-framework").SecretTextProperty<true>;
+    pushInstanceId: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+    pushSecretKey: import("@activepieces/pieces-framework").SecretTextProperty<false>;
+    baseUrl: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+}>, {
+    room: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    count: import("@activepieces/pieces-framework").NumberProperty<true>;
+}>;
+//# sourceMappingURL=admit-waiting-room.d.ts.map

package/dist/src/lib/actions/admit-waiting-room.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admit-waiting-room.d.ts","sourceRoot":"","sources":["../../../../src/lib/actions/admit-waiting-room.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,gBAAgB;;;;;;;;;;EAqB3B,CAAC"}

package/dist/src/lib/actions/admit-waiting-room.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.admitWaitingRoom = void 0;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const auth_1 = require("../auth");
+const client_1 = require("../common/client");
+const waiting_room_1 = require("../common/waiting-room");
+exports.admitWaitingRoom = (0, pieces_framework_1.createAction)({
+    auth: auth_1.hibiraAuth,
+    name: 'admit_waiting_room',
+    displayName: 'Admit Visitors',
+    description: 'Lets the next visitors in a waiting room through now, on top of the steady rate.',
+    props: {
+        room: waiting_room_1.roomProp,
+        count: pieces_framework_1.Property.Number({
+            displayName: 'Visitors',
+            description: 'How many of the next visitors to admit.',
+            required: true,
+            defaultValue: 100,
+        }),
+    },
+    async run({ auth, propsValue }) {
+        return client_1.hibiraClient.channels(auth, {
+            method: 'POST',
+            path: (0, waiting_room_1.roomPath)(propsValue.room, '/admit'),
+            body: { count: propsValue.count },
+        });
+    },
+});

package/dist/src/lib/actions/delete-waiting-room.d.ts

@@ -0,0 +1,11 @@
+export declare const deleteWaitingRoom: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").CustomAuthProperty<{
+    appId: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    key: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    secret: import("@activepieces/pieces-framework").SecretTextProperty<true>;
+    pushInstanceId: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+    pushSecretKey: import("@activepieces/pieces-framework").SecretTextProperty<false>;
+    baseUrl: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+}>, {
+    room: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+}>;
+//# sourceMappingURL=delete-waiting-room.d.ts.map

package/dist/src/lib/actions/delete-waiting-room.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-waiting-room.d.ts","sourceRoot":"","sources":["../../../../src/lib/actions/delete-waiting-room.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,iBAAiB;;;;;;;;;EAY5B,CAAC"}

package/dist/src/lib/actions/delete-waiting-room.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deleteWaitingRoom = void 0;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const auth_1 = require("../auth");
+const client_1 = require("../common/client");
+const waiting_room_1 = require("../common/waiting-room");
+exports.deleteWaitingRoom = (0, pieces_framework_1.createAction)({
+    auth: auth_1.hibiraAuth,
+    name: 'delete_waiting_room',
+    displayName: 'Delete Waiting Room',
+    description: 'Deletes a waiting room and its queue.',
+    props: {
+        room: waiting_room_1.roomProp,
+    },
+    async run({ auth, propsValue }) {
+        const result = await client_1.hibiraClient.channels(auth, { method: 'DELETE', path: (0, waiting_room_1.roomPath)(propsValue.room) });
+        return { room: propsValue.room.trim(), ...result };
+    },
+});

package/dist/src/lib/actions/get-approval.d.ts

@@ -0,0 +1,12 @@
+export declare const getApproval: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").CustomAuthProperty<{
+    appId: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    key: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    secret: import("@activepieces/pieces-framework").SecretTextProperty<true>;
+    pushInstanceId: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+    pushSecretKey: import("@activepieces/pieces-framework").SecretTextProperty<false>;
+    baseUrl: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+}>, {
+    approvalId: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    maxWaitMinutes: import("@activepieces/pieces-framework").NumberProperty<false>;
+}>;
+//# sourceMappingURL=get-approval.d.ts.map

package/dist/src/lib/actions/get-approval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-approval.d.ts","sourceRoot":"","sources":["../../../../src/lib/actions/get-approval.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,WAAW;;;;;;;;;;EAyBtB,CAAC"}

package/dist/src/lib/actions/get-approval.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getApproval = void 0;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const auth_1 = require("../auth");
+const approvals_1 = require("../common/approvals");
+const client_1 = require("../common/client");
+exports.getApproval = (0, pieces_framework_1.createAction)({
+    auth: auth_1.hibiraAuth,
+    name: 'get_approval',
+    displayName: 'Get Approval',
+    description: 'Gets the status (pending, approved, rejected or expired) and answer of an approval request.',
+    props: {
+        approvalId: pieces_framework_1.Property.ShortText({
+            displayName: 'Approval ID',
+            description: 'The approval_id returned by Request Approval (apr_...).',
+            required: true,
+        }),
+        maxWaitMinutes: pieces_framework_1.Property.Number({
+            displayName: 'Wait (Minutes)',
+            description: `Wait up to this long (0 to ${approvals_1.MAX_WAIT_MINUTES}) for a pending request to be answered. 0 returns at once.`,
+            required: false,
+            defaultValue: 0,
+        }),
+    },
+    async run({ auth, propsValue }) {
+        const current = await client_1.hibiraClient.channels(auth, {
+            method: 'GET',
+            path: `/approvals/${encodeURIComponent(propsValue.approvalId.trim())}`,
+        });
+        return (0, approvals_1.waitForApproval)(auth, current, propsValue.maxWaitMinutes ?? 0);
+    },
+});

package/dist/src/lib/actions/get-waiting-room.d.ts

@@ -0,0 +1,11 @@
+export declare const getWaitingRoom: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").CustomAuthProperty<{
+    appId: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    key: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    secret: import("@activepieces/pieces-framework").SecretTextProperty<true>;
+    pushInstanceId: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+    pushSecretKey: import("@activepieces/pieces-framework").SecretTextProperty<false>;
+    baseUrl: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+}>, {
+    room: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+}>;
+//# sourceMappingURL=get-waiting-room.d.ts.map

package/dist/src/lib/actions/get-waiting-room.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-waiting-room.d.ts","sourceRoot":"","sources":["../../../../src/lib/actions/get-waiting-room.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,cAAc;;;;;;;;;EAWzB,CAAC"}

package/dist/src/lib/actions/get-waiting-room.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getWaitingRoom = void 0;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const auth_1 = require("../auth");
+const client_1 = require("../common/client");
+const waiting_room_1 = require("../common/waiting-room");
+exports.getWaitingRoom = (0, pieces_framework_1.createAction)({
+    auth: auth_1.hibiraAuth,
+    name: 'get_waiting_room',
+    displayName: 'Get Waiting Room',
+    description: "Gets a waiting room's settings and how many visitors are waiting and admitted.",
+    props: {
+        room: waiting_room_1.roomProp,
+    },
+    async run({ auth, propsValue }) {
+        return client_1.hibiraClient.channels(auth, { method: 'GET', path: (0, waiting_room_1.roomPath)(propsValue.room) });
+    },
+});

package/dist/src/lib/actions/request-approval.d.ts

@@ -0,0 +1,19 @@
+export declare const requestApproval: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").CustomAuthProperty<{
+    appId: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    key: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    secret: import("@activepieces/pieces-framework").SecretTextProperty<true>;
+    pushInstanceId: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+    pushSecretKey: import("@activepieces/pieces-framework").SecretTextProperty<false>;
+    baseUrl: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+}>, {
+    title: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    options: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+    details: import("@activepieces/pieces-framework").LongTextProperty<false>;
+    waitForAnswer: import("@activepieces/pieces-framework").CheckboxProperty<false>;
+    maxWaitMinutes: import("@activepieces/pieces-framework").NumberProperty<false>;
+    expiresInMinutes: import("@activepieces/pieces-framework").NumberProperty<false>;
+    channel: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+    pushInterests: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+    pushUsers: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+}>;
+//# sourceMappingURL=request-approval.d.ts.map

package/dist/src/lib/actions/request-approval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-approval.d.ts","sourceRoot":"","sources":["../../../../src/lib/actions/request-approval.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;EAuE1B,CAAC"}

package/dist/src/lib/actions/request-approval.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requestApproval = void 0;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const auth_1 = require("../auth");
+const approvals_1 = require("../common/approvals");
+const client_1 = require("../common/client");
+exports.requestApproval = (0, pieces_framework_1.createAction)({
+    auth: auth_1.hibiraAuth,
+    name: 'request_approval',
+    displayName: 'Request Approval',
+    description: 'Asks a person to approve or choose through a Hibira-hosted answer link, and can wait for the answer.',
+    props: {
+        title: pieces_framework_1.Property.ShortText({
+            displayName: 'Question',
+            description: 'What needs a decision, as a short question (at most 200 characters), such as "Refund order #1042 for $89?".',
+            required: true,
+        }),
+        options: pieces_framework_1.Property.ShortText({
+            displayName: 'Choices',
+            description: '2 to 4 choices, separated by commas. The first one approves; any other rejects.',
+            required: false,
+            defaultValue: 'Approve, Reject',
+        }),
+        details: pieces_framework_1.Property.LongText({
+            displayName: 'Details',
+            description: 'Context shown to the person: what will happen and why (at most 4000 characters).',
+            required: false,
+        }),
+        waitForAnswer: pieces_framework_1.Property.Checkbox({
+            displayName: 'Wait for Answer',
+            description: `Keep the flow at this step until the person answers, for up to ${approvals_1.MAX_WAIT_MINUTES} minutes. Otherwise the step returns the link at once; check later with Get Approval.`,
+            required: false,
+            defaultValue: true,
+        }),
+        maxWaitMinutes: pieces_framework_1.Property.Number({
+            displayName: 'Max Wait (Minutes)',
+            description: `Stop waiting after this long (1 to ${approvals_1.MAX_WAIT_MINUTES}) and return the request as still pending.`,
+            required: false,
+            defaultValue: 5,
+        }),
+        expiresInMinutes: pieces_framework_1.Property.Number({
+            displayName: 'Expires In (Minutes)',
+            description: 'How long the link can be answered (default 60, at most 10080 = 7 days).',
+            required: false,
+        }),
+        channel: pieces_framework_1.Property.ShortText({
+            displayName: 'Channel',
+            description: 'Channel to announce the request and its answer on, for the @hibira-io/approvals inbox components.',
+            required: false,
+        }),
+        pushInterests: pieces_framework_1.Property.ShortText({
+            displayName: 'Push to Interests',
+            description: 'Send the link as a push notification to these interests, separated by commas (the app needs Push enabled).',
+            required: false,
+        }),
+        pushUsers: pieces_framework_1.Property.ShortText({
+            displayName: 'Push to User IDs',
+            description: 'Send the link as a push notification to these user IDs instead of interests.',
+            required: false,
+        }),
+    },
+    async run({ auth, propsValue }) {
+        const body = { title: propsValue.title, agent: 'Activepieces' };
+        const options = (0, client_1.splitList)(propsValue.options);
+        if (options.length > 0)
+            body['options'] = options;
+        if (propsValue.details)
+            body['details'] = propsValue.details;
+        if (propsValue.expiresInMinutes)
+            body['expires_in_minutes'] = propsValue.expiresInMinutes;
+        if (propsValue.channel)
+            body['channel'] = propsValue.channel;
+        const interests = (0, client_1.splitList)(propsValue.pushInterests);
+        const users = (0, client_1.splitList)(propsValue.pushUsers);
+        if (interests.length > 0)
+            body['push_interests'] = interests;
+        if (users.length > 0)
+            body['push_users'] = users;
+        const created = await client_1.hibiraClient.channels(auth, { method: 'POST', path: '/approvals', body });
+        if (propsValue.waitForAnswer === false)
+            return created;
+        return (0, approvals_1.waitForApproval)(auth, created, propsValue.maxWaitMinutes ?? 5);
+    },
+});

package/dist/src/lib/actions/update-waiting-room.d.ts

@@ -0,0 +1,18 @@
+export declare const updateWaitingRoom: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").CustomAuthProperty<{
+    appId: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    key: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    secret: import("@activepieces/pieces-framework").SecretTextProperty<true>;
+    pushInstanceId: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+    pushSecretKey: import("@activepieces/pieces-framework").SecretTextProperty<false>;
+    baseUrl: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+}>, {
+    room: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    admitPerMinute: import("@activepieces/pieces-framework").NumberProperty<false>;
+    state: import("@activepieces/pieces-framework").StaticDropdownProperty<string, false>;
+    startsAt: import("@activepieces/pieces-framework").DateTimeProperty<false>;
+    title: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+    burst: import("@activepieces/pieces-framework").NumberProperty<false>;
+    passTtlSeconds: import("@activepieces/pieces-framework").NumberProperty<false>;
+    returnUrls: import("@activepieces/pieces-framework").LongTextProperty<false>;
+}>;
+//# sourceMappingURL=update-waiting-room.d.ts.map

package/dist/src/lib/actions/update-waiting-room.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-waiting-room.d.ts","sourceRoot":"","sources":["../../../../src/lib/actions/update-waiting-room.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;EA8D5B,CAAC"}

package/dist/src/lib/actions/update-waiting-room.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateWaitingRoom = void 0;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const auth_1 = require("../auth");
+const client_1 = require("../common/client");
+const waiting_room_1 = require("../common/waiting-room");
+exports.updateWaitingRoom = (0, pieces_framework_1.createAction)({
+    auth: auth_1.hibiraAuth,
+    name: 'update_waiting_room',
+    displayName: 'Create or Update Waiting Room',
+    description: 'Creates a waiting room, or changes its state, admission rate, start time or other settings.',
+    props: {
+        room: waiting_room_1.roomProp,
+        admitPerMinute: pieces_framework_1.Property.Number({
+            displayName: 'Admit per Minute',
+            description: 'How many visitors to let through each minute. Required when the room is new; leave empty to keep the current rate.',
+            required: false,
+        }),
+        state: pieces_framework_1.Property.StaticDropdown({
+            displayName: 'State',
+            description: 'Leave empty to keep the current state. A new room opens.',
+            required: false,
+            options: {
+                options: [
+                    { label: 'Open', value: 'open' },
+                    { label: 'Paused (visitors can join, nobody is admitted)', value: 'paused' },
+                    { label: 'Closed (nobody can join)', value: 'closed' },
+                ],
+            },
+        }),
+        startsAt: pieces_framework_1.Property.DateTime({
+            displayName: 'Starts At',
+            description: 'When admission starts. Visitors can join the queue before then.',
+            required: false,
+        }),
+        title: pieces_framework_1.Property.ShortText({
+            displayName: 'Title',
+            description: 'Shown on the waiting page, at most 120 characters.',
+            required: false,
+        }),
+        burst: pieces_framework_1.Property.Number({
+            displayName: 'Burst',
+            description: 'How many visitors may be admitted at once when the queue starts moving.',
+            required: false,
+        }),
+        passTtlSeconds: pieces_framework_1.Property.Number({
+            displayName: 'Pass Lifetime (Seconds)',
+            description: 'How long an admitted visitor stays in: 60 to 86400. Default 1800.',
+            required: false,
+        }),
+        returnUrls: pieces_framework_1.Property.LongText({
+            displayName: 'Return URLs',
+            description: 'Comma or newline separated https addresses visitors may be sent back to (http only for localhost). Up to 10.',
+            required: false,
+        }),
+    },
+    async run({ auth, propsValue }) {
+        const p = propsValue;
+        const body = {};
+        if (p.admitPerMinute)
+            body['admit_per_minute'] = p.admitPerMinute;
+        if (p.state)
+            body['state'] = p.state;
+        if (p.startsAt)
+            body['starts_at'] = new Date(p.startsAt).toISOString().replace(/\.\d{3}Z$/, 'Z');
+        if (p.title)
+            body['title'] = p.title;
+        if (p.burst)
+            body['burst'] = p.burst;
+        if (p.passTtlSeconds)
+            body['pass_ttl_seconds'] = p.passTtlSeconds;
+        if (p.returnUrls)
+            body['return_urls'] = (0, client_1.splitList)(p.returnUrls);
+        return client_1.hibiraClient.channels(auth, { method: 'POST', path: (0, waiting_room_1.roomPath)(p.room), body });
+    },
+});

package/dist/src/lib/actions/verify-waiting-room-pass.d.ts

@@ -0,0 +1,12 @@
+export declare const verifyWaitingRoomPass: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").CustomAuthProperty<{
+    appId: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    key: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    secret: import("@activepieces/pieces-framework").SecretTextProperty<true>;
+    pushInstanceId: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+    pushSecretKey: import("@activepieces/pieces-framework").SecretTextProperty<false>;
+    baseUrl: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+}>, {
+    room: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    pass: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+}>;
+//# sourceMappingURL=verify-waiting-room-pass.d.ts.map

package/dist/src/lib/actions/verify-waiting-room-pass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-waiting-room-pass.d.ts","sourceRoot":"","sources":["../../../../src/lib/actions/verify-waiting-room-pass.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,qBAAqB;;;;;;;;;;EAqBhC,CAAC"}

package/dist/src/lib/actions/verify-waiting-room-pass.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.verifyWaitingRoomPass = void 0;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const auth_1 = require("../auth");
+const client_1 = require("../common/client");
+const waiting_room_1 = require("../common/waiting-room");
+exports.verifyWaitingRoomPass = (0, pieces_framework_1.createAction)({
+    auth: auth_1.hibiraAuth,
+    name: 'verify_waiting_room_pass',
+    displayName: 'Verify Waiting Room Pass',
+    description: 'Checks a pass a visitor brought back from the waiting room. Record ticket_id to allow one checkout per place in line.',
+    props: {
+        room: waiting_room_1.roomProp,
+        pass: pieces_framework_1.Property.ShortText({
+            displayName: 'Pass',
+            description: 'The hibira_pass query parameter, or the hibira_wr_<room> cookie value.',
+            required: true,
+        }),
+    },
+    async run({ auth, propsValue }) {
+        const result = await client_1.hibiraClient.channels(auth, {
+            method: 'POST',
+            path: (0, waiting_room_1.roomPath)(propsValue.room, '/verify'),
+            body: { pass: propsValue.pass.trim() },
+        });
+        return { room: propsValue.room.trim(), ...result };
+    },
+});

package/dist/src/lib/common/approvals.d.ts

@@ -0,0 +1,18 @@
+import { HibiraAuthProps } from './client';
+export type Approval = {
+    approval_id: string;
+    status: 'pending' | 'approved' | 'rejected' | 'expired';
+    url?: string;
+    [key: string]: unknown;
+};
+/** Longest wait a step may hold a flow (Activepieces stops steps after 10 minutes). */
+export declare const MAX_WAIT_MINUTES = 9;
+/**
+ * Long-polls an approval (25 s per request, no timers) until it is answered
+ * or expires, or maxWaitMinutes runs out. Keeps the answer link of the
+ * request in the result.
+ */
+export declare function waitForApproval(auth: {
+    props: HibiraAuthProps;
+} | HibiraAuthProps, approval: Approval, maxWaitMinutes: number): Promise<Approval>;
+//# sourceMappingURL=approvals.d.ts.map

package/dist/src/lib/common/approvals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approvals.d.ts","sourceRoot":"","sources":["../../../../src/lib/common/approvals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,eAAe,EAAE,MAAM,UAAU,CAAC;AAEzD,MAAM,MAAM,QAAQ,GAAG;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE;IAAE,KAAK,EAAE,eAAe,CAAA;CAAE,GAAG,eAAe,EAClD,QAAQ,EAAE,QAAQ,EAClB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,QAAQ,CAAC,CAgBnB"}

package/dist/src/lib/common/approvals.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_WAIT_MINUTES = void 0;
+exports.waitForApproval = waitForApproval;
+const client_1 = require("./client");
+/** Longest wait a step may hold a flow (Activepieces stops steps after 10 minutes). */
+exports.MAX_WAIT_MINUTES = 9;
+/**
+ * Long-polls an approval (25 s per request, no timers) until it is answered
+ * or expires, or maxWaitMinutes runs out. Keeps the answer link of the
+ * request in the result.
+ */
+async function waitForApproval(auth, approval, maxWaitMinutes) {
+    const minutes = Math.min(Math.max(maxWaitMinutes, 0), exports.MAX_WAIT_MINUTES);
+    const deadline = Date.now() + minutes * 60_000;
+    let current = approval;
+    while (current.status === 'pending') {
+        const left = Math.floor((deadline - Date.now()) / 1000);
+        if (left <= 0)
+            break;
+        const next = await client_1.hibiraClient.channels(auth, {
+            method: 'GET',
+            path: `/approvals/${encodeURIComponent(approval.approval_id)}`,
+            query: { wait: String(Math.min(25, left)) },
+            timeout: 40_000,
+        });
+        current = approval.url === undefined ? next : { ...next, url: approval.url };
+    }
+    return current;
+}

package/dist/src/lib/common/client.d.ts

@@ -13,11 +13,12 @@ type AuthValue = {
 export declare function splitList(value: string | string[] | undefined): string[];
 export declare const hibiraClient: {
     /** Signed request to the app's Channels HTTP API (/apps/{appId}{path}). */
-    channels<T = Record<string, unknown>>(auth: AuthValue, { method, path, query, body, }: {
+    channels<T = Record<string, unknown>>(auth: AuthValue, { method, path, query, body, timeout, }: {
         method: "GET" | "POST" | "DELETE";
         path: string;
         query?: Record<string, string>;
         body?: unknown;
+        timeout?: number;
     }): Promise<T>;
     /** Request to the Beams-compatible push API, with {instance} filled in. */
     push<T = Record<string, unknown>>(auth: AuthValue, { method, path, body }: {

package/dist/src/lib/common/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/lib/common/client.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,KAAK,SAAS,GAAG;IAAE,KAAK,EAAE,eAAe,CAAA;CAAE,GAAG,eAAe,CAAC;AAU9D,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,CAGxE;AAED,eAAO,MAAM,YAAY;IACvB,2EAA2E;aAC5D,CAAC,kCACR,SAAS,kCAMZ;QAAE,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GACrG,OAAO,CAAC,CAAC,CAAC;IAeb,2EAA2E;SAChE,CAAC,kCACJ,SAAS,0BACS;QAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAClF,OAAO,CAAC,CAAC,CAAC;CAad,CAAC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/lib/common/client.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,KAAK,SAAS,GAAG;IAAE,KAAK,EAAE,eAAe,CAAA;CAAE,GAAG,eAAe,CAAC;AAU9D,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,CAGxE;AAED,eAAO,MAAM,YAAY;IACvB,2EAA2E;aAC5D,CAAC,kCACR,SAAS,2CAOZ;QACD,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;QAClC,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GACA,OAAO,CAAC,CAAC,CAAC;IAgBb,2EAA2E;SAChE,CAAC,kCACJ,SAAS,0BACS;QAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAClF,OAAO,CAAC,CAAC,CAAC;CAad,CAAC"}

package/dist/src/lib/common/client.js

@@ -17,7 +17,7 @@ function splitList(value) {
 }
 exports.hibiraClient = {
     /** Signed request to the app's Channels HTTP API (/apps/{appId}{path}). */
-    async channels(auth, { method, path, query = {}, body, }) {
+    async channels(auth, { method, path, query = {}, body, timeout, }) {
         const a = props(auth);
         const fullPath = `/apps/${encodeURIComponent(a.appId)}${path}`;
         const raw = body === undefined ? undefined : JSON.stringify(body);
@@ -28,6 +28,7 @@ exports.hibiraClient = {
             queryParams,
             headers: raw === undefined ? {} : { 'Content-Type': 'application/json' },
             body: raw,
+            ...(timeout === undefined ? {} : { timeout }),
         });
         return response.body;
     },

package/dist/src/lib/common/waiting-room.d.ts

@@ -0,0 +1,19 @@
+export declare const roomProp: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+/** The path of a room in the signed waiting room API. */
+export declare function roomPath(room: string, action?: string): string;
+export type WaitingRoom = {
+    room: string;
+    title?: string;
+    state: 'open' | 'paused' | 'closed';
+    admitted: number;
+    issued: number;
+    waiting: number;
+    admit_per_minute: number;
+    starts_at?: string;
+    channel: string;
+    burst: number;
+    pass_ttl_seconds: number;
+    return_urls: string[];
+    [key: string]: unknown;
+};
+//# sourceMappingURL=waiting-room.d.ts.map

package/dist/src/lib/common/waiting-room.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waiting-room.d.ts","sourceRoot":"","sources":["../../../../src/lib/common/waiting-room.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ,kEAInB,CAAC;AAEH,yDAAyD;AACzD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAK,GAAG,MAAM,CAE1D;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC"}

package/dist/src/lib/common/waiting-room.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.roomProp = void 0;
+exports.roomPath = roomPath;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+exports.roomProp = pieces_framework_1.Property.ShortText({
+    displayName: 'Room',
+    description: "The waiting room's name: 1 to 64 letters, digits, '-' or '_', such as presale.",
+    required: true,
+});
+/** The path of a room in the signed waiting room API. */
+function roomPath(room, action = '') {
+    return `/waiting_rooms/${encodeURIComponent(room.trim())}${action}`;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hibira-io/piece-hibira",
-  "version": "0.1.1",
-  "description": "Hibira piece for Activepieces: realtime events, presence, push notifications and a webhook trigger",
+  "version": "0.3.0",
+  "description": "Hibira piece for Activepieces: realtime events, presence, push notifications, approvals, waiting rooms and a webhook trigger",
   "keywords": [
     "activepieces",
     "activepieces-piece",