@newhomestar/sdk 0.8.12 → 0.8.14

package/dist/events.js

@@ -782,7 +782,7 @@ export async function withInboundEvent(db, msg, handler) {
                 'Content-Type': 'application/json',
             },
             body: JSON.stringify({
-                queue_name: queueName,
+                queue: queueName,
                 msg_id: Number(msgId),
             }),
         });
@@ -892,7 +892,7 @@ export function startInboundConsumer(db, options) {
                     'Authorization': `Bearer ${serviceToken}`,
                     'Content-Type': 'application/json',
                 },
-                body: JSON.stringify({ queue_name: queueName, msg_id: msgId }),
+                body: JSON.stringify({ queue: queueName, msg_id: msgId }),
             });
         }
         catch (err) {
@@ -923,7 +923,7 @@ export function startInboundConsumer(db, options) {
                 await fetch(`${eventsUrl}/events/queue/ack`, {
                     method: 'POST',
                     headers: { 'Authorization': `Bearer ${serviceToken}`, 'Content-Type': 'application/json' },
-                    body: JSON.stringify({ queue_name: queueName, msg_id: msgId }),
+                    body: JSON.stringify({ queue: queueName, msg_id: msgId }),
                 });
             }
             catch { /* best-effort */ }

package/dist/index.js

@@ -906,12 +906,29 @@ export function runHttpServer(def, opts = {}) {
                         // Resolve credentials (same flow as action handlers)
                         const credCtx = buildCredentialCtx(def.name, authToken);
                         const credentials = await credCtx.resolveCredentials();
-                        // Build OptionsContext for the handler
+                        // Extract and normalize the scope identifiers from the request body.
+                        // The UI posts `{ config, remoteId, remoteType }`. Both may be null
+                        // for legacy / unscoped lookups. We keep them typed so handlers
+                        // using `ctx.remoteId` get proper autocomplete.
+                        const rawRemoteId = req.body?.remoteId;
+                        const rawRemoteType = req.body?.remoteType;
+                        const remoteId = typeof rawRemoteId === 'string' && rawRemoteId.trim() !== ''
+                            ? rawRemoteId
+                            : null;
+                        const remoteType = rawRemoteType === 'account' || rawRemoteType === 'company'
+                            ? rawRemoteType
+                            : null;
+                        // Build OptionsContext for the handler. `remoteId`/`remoteType`
+                        // let the handler scope its lookup to the currently-selected
+                        // ticketing account / HRIS company (e.g. list only Jira
+                        // projects tied to *this* account's connection).
                         const optionsCtx = {
                             fetch: credCtx.fetch,
                             config: req.body?.config ?? {},
                             credentials,
                             tenantId: req.auth?.sub ?? 'unknown',
+                            remoteId,
+                            remoteType,
                         };
                         // Run the optionsFetcher handler
                         console.log(`[nova] 🔧 Running optionsFetcher for config field "${field.key}"`);

package/dist/integration.d.ts

@@ -144,6 +144,26 @@ export interface OptionsContext {
     credentials: ResolvedCredentials;
     /** Tenant ID for calling internal Nova platform services */
     tenantId: string;
+    /**
+     * Scope UUID this options lookup belongs to. For ticketing integrations
+     * this is the `TicketingAccount.id`; for HRIS integrations it's the
+     * `HrisCompany.id`. May be null/undefined when the caller hasn't
+     * selected a scope yet (legacy / unscoped lookups).
+     *
+     * Use this to filter the options query when the same user administers
+     * multiple accounts — e.g. only list Jira projects linked to this
+     * specific ticketing account's connection, not all of the user's
+     * accessible projects.
+     */
+    remoteId?: string | null;
+    /**
+     * Scope type discriminator so the handler knows which domain the
+     * `remoteId` came from without having to infer it from the integration
+     * category.
+     *   • "account" → ticketing (TicketingAccount.id)
+     *   • "company" → HRIS (HrisCompany.id)
+     */
+    remoteType?: 'account' | 'company' | null;
 }
 /**
  * A handler function that fetches select options dynamically.

package/dist/next.d.ts

@@ -123,6 +123,19 @@ export interface NovaIamResourceDef {
     parent_resource_path?: string;
     /** Arbitrary metadata stored on the resource record */
     metadata?: Record<string, unknown>;
+    /**
+     * Free-text grouping bucket used by Odyssey's role-edit modal to render
+     * top-level sections (e.g. 'core', 'manage', 'admin'). When omitted, the
+     * resource inherits the service-level default declared at `iam.scope`, then
+     * falls back to inheriting from its `parent_resource_path` if still unset.
+     * Common values:
+     *   - 'core'   → end-user / day-to-day modules (employees, leave, etc.)
+     *   - 'manage' → manager / supervisor surfaces
+     *   - 'admin'  → administrative tools and settings
+     * Free-form — any string is accepted; the UI renders unknown values
+     * alphabetically after the canonical core/manage/admin order.
+     */
+    scope?: string;
 }
 /**
  * FGA check declared on a novaEndpoint() — runtime-only.
@@ -803,6 +816,12 @@ export interface ServiceDef {
      */
     iam?: {
         resources: NovaIamResourceDef[];
+        /**
+         * Service-level default `scope` applied to every resource that doesn't
+         * declare one explicitly. Free-text — common values: 'core', 'manage',
+         * 'admin'. See `NovaIamResourceDef.scope` for full inheritance rules.
+         */
+        scope?: string;
     };
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newhomestar/sdk",
-  "version": "0.8.12",
+  "version": "0.8.14",
   "description": "Type-safe SDK for building Nova pipelines (workers & functions)",
   "homepage": "https://github.com/newhomestar/nova-node-sdk#readme",
   "bugs": {