@newhomestar/sdk 0.8.12 → 0.8.13

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

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