@unboundcx/sdk-internal 2.0.1 → 2.1.0

package/index.js

@@ -8,6 +8,7 @@ import { InternalServersService } from './services/servers.js';
 import { InternalSocketService } from './services/socket.js';
 import { InternalMasterAuthService } from './services/masterAuth.js';
 import { InternalBrandingService } from './services/branding.js';
+import { InternalPhoneNumbersService } from './services/phoneNumbers.js';
 
 export class InternalSDK {
   constructor(sdk, buildMasterApiAuthFn) {
@@ -22,6 +23,7 @@ export class InternalSDK {
     this.socket = new InternalSocketService(sdk);
     this.masterAuth = new InternalMasterAuthService(sdk);
     this.branding = new InternalBrandingService(sdk);
+    this.phoneNumbers = new InternalPhoneNumbersService(sdk);
 
     // Proxy all base SDK properties and methods
     this._proxyBaseSDK();
@@ -123,3 +125,4 @@ export {
 export { InternalSocketService } from './services/socket.js';
 export { InternalMasterAuthService } from './services/masterAuth.js';
 export { InternalBrandingService } from './services/branding.js';
+export { InternalPhoneNumbersService } from './services/phoneNumbers.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk-internal",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "description": "Internal SDK extension for Unbound - Provides access to internal APIs and administrative functions",
   "main": "index.js",
   "type": "module",
@@ -53,7 +53,7 @@
   },
   "dependencies": {},
   "peerDependencies": {
-    "@unboundcx/sdk": "^2.0.0"
+    "@unboundcx/sdk": ">=2.0.0 <5.0.0"
   },
   "devDependencies": {},
   "publishConfig": {

package/services/masterAuth.js

@@ -32,4 +32,37 @@ export class InternalMasterAuthService {
     );
     return result;
   }
+
+  /**
+   * Mint an internal service token — the kind baked into pods as BOOT_TOKEN.
+   *
+   * Requires internal auth (the caller must already hold a valid internal
+   * token). Intended for manual/operational use: the returned token is stored
+   * in Zeus connection storage and injected into the services that need it.
+   *
+   * @param {object}  [opts]
+   * @param {string}  [opts.service='internal'] - value for the `service` claim
+   * @param {number}  [opts.expiresIn]          - lifetime in seconds; omit for a
+   *                                              non-expiring token (matches the
+   *                                              legacy BOOT_TOKEN)
+   */
+  async createInternalToken({ service = 'internal', expiresIn } = {}) {
+    this.sdk.validateParams(
+      { service, expiresIn },
+      {
+        service: { type: 'string', required: false },
+        expiresIn: { type: 'number', required: false },
+      },
+    );
+
+    const body = { service };
+    if (expiresIn !== undefined) body.expiresIn = expiresIn;
+
+    const result = await this.sdk._fetch(
+      '/internal/masterAuth/internal-token',
+      'POST',
+      { body },
+    );
+    return result;
+  }
 }

package/services/phoneNumbers.js

@@ -0,0 +1,31 @@
+export class InternalPhoneNumbersService {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+
+  /**
+   * Claim a number from Telnyx into the global phoneNumbers inventory as an
+   * unassigned row. Requires an internal auth token — this bypasses normal
+   * ordering/billing and is not part of the public SDK.
+   *
+   * @param {Object} params
+   * @param {string} params.phoneNumber - +E.164 number that already exists on the Telnyx account
+   */
+  async createInventory({ phoneNumber }) {
+    this.sdk.validateParams(
+      { phoneNumber },
+      {
+        phoneNumber: { type: 'string', required: true },
+      },
+    );
+
+    const result = await this.sdk._fetch(
+      '/internal/phoneNumbers/inventory',
+      'POST',
+      {
+        body: { phoneNumber },
+      },
+    );
+    return result;
+  }
+}