@hibira-io/piece-hibira 0.1.1 → 0.2.0

package/README.md

@@ -30,6 +30,7 @@ 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.
 
 ## Trigger
 

package/dist/src/i18n/translation.json

@@ -67,5 +67,30 @@
   "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."
+}

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;AAaxC,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB,eAAO,MAAM,MAAM;;;;;;;GAqBjB,CAAC"}

package/dist/src/index.js

@@ -6,11 +6,13 @@ 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 new_webhook_event_1 = require("./lib/triggers/new-webhook-event");
@@ -31,6 +33,8 @@ 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,
     ],
     triggers: [new_webhook_event_1.newWebhookEvent],
 });

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/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/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/package.json

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