@fonoster/sipnet 0.27.0 → 0.31.0

package/dist/acls/updateAcl.d.ts

@@ -1,22 +1,3 @@
-/**
- * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
- * http://github.com/fonoster/fonoster
- *
- * This file is part of Fonoster
- *
- * Licensed under the MIT License (the "License");
- * you may not use this file except in compliance with
- * the License. You may obtain a copy of the License at
- *
- *    https://opensource.org/licenses/MIT
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import { GrpcErrorMessage } from "@fonoster/common";
 import { AclsApi } from "@fonoster/types";
 declare function updateAcl(api: AclsApi): (call: {
     request: unknown;

package/dist/acls/updateAcl.js

@@ -29,15 +29,16 @@ exports.updateAcl = updateAcl;
  * limitations under the License.
  */
 const common_1 = require("@fonoster/common");
+const identity_1 = require("@fonoster/identity");
 const logger_1 = require("@fonoster/logger");
 const logger = (0, logger_1.getLogger)({ service: "sipnet", filePath: __filename });
 function updateAcl(api) {
-    const fn = (call, callback) => __awaiter(this, void 0, void 0, function* () {
+    const fn = (call) => __awaiter(this, void 0, void 0, function* () {
         const { request } = call;
         const accessKeyId = (0, common_1.getAccessKeyIdFromCall)(call);
         logger.verbose("call to updateAcl", Object.assign(Object.assign({}, request), { accessKeyId }));
-        const response = yield api.updateAcl(Object.assign(Object.assign({}, request), { deny: ["0.0.0.0/0"] }));
-        callback(null, response);
+        return yield api.updateAcl(Object.assign(Object.assign({}, request), { deny: ["0.0.0.0/0"] }));
     });
-    return (0, common_1.withErrorHandlingAndValidation)(fn, common_1.Validators.updateAclRequestSchema);
+    // Only the caller's own ACLs can be updated, like every other resource.
+    return (0, common_1.withErrorHandlingAndValidation)((0, identity_1.withAccess)(fn, ((ref) => api.getAcl(ref))), common_1.Validators.updateAclRequestSchema);
 }

package/dist/agents/buildService.js

@@ -23,9 +23,11 @@ exports.buildService = buildService;
  * limitations under the License.
  */
 const sdk_1 = __importDefault(require("@routr/sdk"));
+const checkRefs_1 = require("../resources/checkRefs");
 const operations_1 = require("./operations");
 function buildService(clientOptions) {
     const client = new sdk_1.default.Agents(clientOptions);
+    const checkRefs = (0, checkRefs_1.createCheckRefs)((0, checkRefs_1.createRefLookups)(clientOptions));
     return {
         definition: {
             serviceName: "Agents",
@@ -34,8 +36,8 @@ function buildService(clientOptions) {
             proto: "agents.proto"
         },
         handlers: {
-            createAgent: (0, operations_1.createAgent)(client),
-            updateAgent: (0, operations_1.updateAgent)(client),
+            createAgent: (0, operations_1.createAgent)(client, checkRefs),
+            updateAgent: (0, operations_1.updateAgent)(client, checkRefs),
             getAgent: (0, operations_1.getAgent)(client),
             listAgents: (0, operations_1.listAgents)(client),
             deleteAgent: (0, operations_1.deleteAgent)(client)

package/dist/agents/operations.d.ts

@@ -1,8 +1,9 @@
 import { AgentsApi } from "@fonoster/types";
-declare function createAgent(agents: AgentsApi): (call: {
+import { CheckRefs } from "../resources/checkRefs";
+declare function createAgent(agents: AgentsApi, checkRefs?: CheckRefs): (call: {
     request: unknown;
 }, callback: (error?: import("@fonoster/common").GrpcErrorMessage, response?: unknown) => void) => Promise<void>;
-declare function updateAgent(agents: AgentsApi): (call: {
+declare function updateAgent(agents: AgentsApi, checkRefs?: CheckRefs): (call: {
     request: unknown;
 }, callback: (error?: import("@fonoster/common").GrpcErrorMessage, response?: unknown) => void) => Promise<void>;
 declare function getAgent(agents: AgentsApi): (call: {

package/dist/agents/operations.js

@@ -24,17 +24,18 @@ exports.updateAgent = updateAgent;
  * limitations under the License.
  */
 const common_1 = require("@fonoster/common");
+const checkRefs_1 = require("../resources/checkRefs");
 const createResource_1 = require("../resources/createResource");
 const deleteResource_1 = require("../resources/deleteResource");
 const getResource_1 = require("../resources/getResource");
 const listResources_1 = require("../resources/listResources");
 const updateResource_1 = require("../resources/updateResource");
 const RESOURCE = "Agent";
-function createAgent(agents) {
-    return (0, createResource_1.createResource)(agents, RESOURCE, common_1.Validators.createAgentRequestSchema);
+function createAgent(agents, checkRefs) {
+    return (0, createResource_1.createResource)(agents, RESOURCE, common_1.Validators.createAgentRequestSchema, (0, checkRefs_1.refsChecker)(checkRefs, checkRefs_1.agentRefs));
 }
-function updateAgent(agents) {
-    return (0, updateResource_1.updateResource)(agents, RESOURCE, common_1.Validators.updateAgentRequestSchema);
+function updateAgent(agents, checkRefs) {
+    return (0, updateResource_1.updateResource)(agents, RESOURCE, common_1.Validators.updateAgentRequestSchema, (0, checkRefs_1.refsChecker)(checkRefs, checkRefs_1.agentRefs));
 }
 function getAgent(agents) {
     return (0, getResource_1.getResource)(agents, RESOURCE);

package/dist/domains/buildService.d.ts

@@ -1,5 +1,11 @@
 import { ClientOptions } from "../types";
-declare function buildService(clientOptions: ClientOptions): {
+/**
+ * `namesRoot` (e.g. `sip.example.com`) makes every domain one label under it;
+ * leave it out to accept any domain.
+ */
+declare function buildService(clientOptions: ClientOptions, options?: {
+    namesRoot?: string;
+}): {
     definition: {
         serviceName: string;
         pckg: string;

package/dist/domains/buildService.js

@@ -23,9 +23,16 @@ exports.buildService = buildService;
  * limitations under the License.
  */
 const sdk_1 = __importDefault(require("@routr/sdk"));
+const checkRefs_1 = require("../resources/checkRefs");
+const sipNames_1 = require("../resources/sipNames");
 const operations_1 = require("./operations");
-function buildService(clientOptions) {
+/**
+ * `namesRoot` (e.g. `sip.example.com`) makes every domain one label under it;
+ * leave it out to accept any domain.
+ */
+function buildService(clientOptions, options = {}) {
     const client = new sdk_1.default.Domains(clientOptions);
+    const checkRefs = (0, checkRefs_1.createCheckRefs)((0, checkRefs_1.createRefLookups)(clientOptions));
     return {
         definition: {
             serviceName: "Domains",
@@ -34,8 +41,8 @@ function buildService(clientOptions) {
             proto: "domains.proto"
         },
         handlers: {
-            createDomain: (0, operations_1.createDomain)(client),
-            updateDomain: (0, operations_1.updateDomain)(client),
+            createDomain: (0, sipNames_1.withSipNameCheck)((0, operations_1.createDomain)(client, checkRefs), "domainUri", "domain", options.namesRoot),
+            updateDomain: (0, sipNames_1.withSipNameCheck)((0, operations_1.updateDomain)(client, checkRefs), "domainUri", "domain", options.namesRoot),
             getDomain: (0, operations_1.getDomain)(client),
             listDomains: (0, operations_1.listDomains)(client),
             deleteDomain: (0, operations_1.deleteDomain)(client)

package/dist/domains/operations.d.ts

@@ -1,8 +1,9 @@
 import { DomainsApi } from "@fonoster/types";
-declare function createDomain(domains: DomainsApi): (call: {
+import { CheckRefs } from "../resources/checkRefs";
+declare function createDomain(domains: DomainsApi, checkRefs?: CheckRefs): (call: {
     request: unknown;
 }, callback: (error?: import("@fonoster/common").GrpcErrorMessage, response?: unknown) => void) => Promise<void>;
-declare function updateDomain(domains: DomainsApi): (call: {
+declare function updateDomain(domains: DomainsApi, checkRefs?: CheckRefs): (call: {
     request: unknown;
 }, callback: (error?: import("@fonoster/common").GrpcErrorMessage, response?: unknown) => void) => Promise<void>;
 declare function getDomain(domains: DomainsApi): (call: {

package/dist/domains/operations.js

@@ -24,17 +24,18 @@ exports.updateDomain = updateDomain;
  * limitations under the License.
  */
 const common_1 = require("@fonoster/common");
+const checkRefs_1 = require("../resources/checkRefs");
 const createResource_1 = require("../resources/createResource");
 const deleteResource_1 = require("../resources/deleteResource");
 const getResource_1 = require("../resources/getResource");
 const listResources_1 = require("../resources/listResources");
 const updateResource_1 = require("../resources/updateResource");
 const RESOURCE = "Domain";
-function createDomain(domains) {
-    return (0, createResource_1.createResource)(domains, RESOURCE, common_1.Validators.createDomainRequestSchema);
+function createDomain(domains, checkRefs) {
+    return (0, createResource_1.createResource)(domains, RESOURCE, common_1.Validators.createDomainRequestSchema, (0, checkRefs_1.refsChecker)(checkRefs, checkRefs_1.domainRefs));
 }
-function updateDomain(domains) {
-    return (0, updateResource_1.updateResource)(domains, RESOURCE, common_1.Validators.updateDomainRequestSchema);
+function updateDomain(domains, checkRefs) {
+    return (0, updateResource_1.updateResource)(domains, RESOURCE, common_1.Validators.updateDomainRequestSchema, (0, checkRefs_1.refsChecker)(checkRefs, checkRefs_1.domainRefs));
 }
 function getDomain(domains) {
     return (0, getResource_1.getResource)(domains, RESOURCE);

package/dist/numbers/buildService.d.ts

@@ -18,7 +18,9 @@
  */
 import { NumberPreconditionsCheck } from "@fonoster/common";
 import { ClientOptions } from "../types";
-declare function buildService(clientOptions: ClientOptions, checkNumberPreconditions: NumberPreconditionsCheck): {
+import { NumberRouting } from "./engineRouting";
+/** `routing` picks the peer app-linked numbers point at (default: the roomr peer). */
+declare function buildService(clientOptions: ClientOptions, checkNumberPreconditions: NumberPreconditionsCheck, routing?: NumberRouting): {
     definition: {
         serviceName: string;
         pckg: string;

package/dist/numbers/buildService.js

@@ -5,13 +5,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildService = buildService;
 const sdk_1 = __importDefault(require("@routr/sdk"));
+const checkRefs_1 = require("../resources/checkRefs");
 const createNumber_1 = require("./createNumber");
 const getNumber_1 = require("./getNumber");
 const listNumbers_1 = require("./listNumbers");
 const operations_1 = require("./operations");
 const updateNumber_1 = require("./updateNumber");
-function buildService(clientOptions, checkNumberPreconditions) {
+/** `routing` picks the peer app-linked numbers point at (default: the roomr peer). */
+function buildService(clientOptions, checkNumberPreconditions, routing) {
     const client = new sdk_1.default.Numbers(clientOptions);
+    const checkRefs = (0, checkRefs_1.createCheckRefs)((0, checkRefs_1.createRefLookups)(clientOptions));
     return {
         definition: {
             serviceName: "Numbers",
@@ -20,8 +23,8 @@ function buildService(clientOptions, checkNumberPreconditions) {
             proto: "numbers.proto"
         },
         handlers: {
-            createNumber: (0, createNumber_1.createNumber)(client, checkNumberPreconditions),
-            updateNumber: (0, updateNumber_1.updateNumber)(client, checkNumberPreconditions),
+            createNumber: (0, createNumber_1.createNumber)(client, checkNumberPreconditions, routing, checkRefs),
+            updateNumber: (0, updateNumber_1.updateNumber)(client, checkNumberPreconditions, routing, checkRefs),
             getNumber: (0, getNumber_1.getNumber)(client),
             listNumbers: (0, listNumbers_1.listNumbers)(client),
             deleteNumber: (0, operations_1.deleteNumber)(client)

package/dist/numbers/convertToRoutrNumber.d.ts

@@ -1,5 +1,9 @@
 import { CreateNumberRequest, UpdateNumberRequest } from "@fonoster/types";
-declare function convertToRoutrNumber(number: CreateNumberRequest, accessKeyId: string): {
+/**
+ * `appPeerAor` is the peer an app-linked number routes to: the roomr peer by default (see
+ * engineRouting.ts).
+ */
+declare function convertToRoutrNumber(number: CreateNumberRequest, accessKeyId: string, appPeerAor?: string): {
     name: string;
     telUrl: string;
     aorLink: string;
@@ -13,7 +17,7 @@ declare function convertToRoutrNumber(number: CreateNumberRequest, accessKeyId:
     trunkRef: string;
     extended: Record<string, unknown>;
 };
-declare function convertToRoutrNumberUpdate(number: UpdateNumberRequest): {
+declare function convertToRoutrNumberUpdate(number: UpdateNumberRequest, appPeerAor?: string): {
     ref: string;
     name: string;
     aorLink: string;

package/dist/numbers/convertToRoutrNumber.js

@@ -21,8 +21,12 @@ exports.convertToRoutrNumberUpdate = convertToRoutrNumberUpdate;
  * limitations under the License.
  */
 const common_1 = require("@fonoster/common");
-function convertToRoutrNumber(number, accessKeyId) {
-    const aorLink = number.appRef ? common_1.ROUTR_DEFAULT_PEER_AOR : number.agentAor;
+/**
+ * `appPeerAor` is the peer an app-linked number routes to: the roomr peer by default (see
+ * engineRouting.ts).
+ */
+function convertToRoutrNumber(number, accessKeyId, appPeerAor = common_1.ROUTR_DEFAULT_PEER_AOR) {
+    const aorLink = number.appRef ? appPeerAor : number.agentAor;
     return {
         name: number.name,
         telUrl: number.telUrl,
@@ -42,11 +46,11 @@ function convertToRoutrNumber(number, accessKeyId) {
         extended: { accessKeyId }
     };
 }
-function convertToRoutrNumberUpdate(number) {
+function convertToRoutrNumberUpdate(number, appPeerAor = common_1.ROUTR_DEFAULT_PEER_AOR) {
     let aorLink;
     let extraHeaders = [];
     if (number.appRef) {
-        aorLink = common_1.ROUTR_DEFAULT_PEER_AOR;
+        aorLink = appPeerAor;
         extraHeaders.push({
             name: common_1.APP_REF_HEADER,
             value: number.appRef

package/dist/numbers/createNumber.d.ts

@@ -18,7 +18,9 @@
  */
 import { GrpcErrorMessage, NumberPreconditionsCheck } from "@fonoster/common";
 import { NumbersApi } from "@fonoster/types";
-declare function createNumber(api: NumbersApi, checkNumberPreconditions: NumberPreconditionsCheck): (call: {
+import { CheckRefs } from "../resources/checkRefs";
+import { NumberRouting } from "./engineRouting";
+declare function createNumber(api: NumbersApi, checkNumberPreconditions: NumberPreconditionsCheck, routing?: NumberRouting, checkRefs?: CheckRefs): (call: {
     request: unknown;
 }, callback: (error?: import("@fonoster/common").GrpcErrorMessage, response?: unknown) => void) => Promise<void>;
 export { createNumber };

package/dist/numbers/createNumber.js

@@ -30,16 +30,25 @@ exports.createNumber = createNumber;
  */
 const common_1 = require("@fonoster/common");
 const logger_1 = require("@fonoster/logger");
+const checkRefs_1 = require("../resources/checkRefs");
 const convertToRoutrNumber_1 = require("./convertToRoutrNumber");
 const logger = (0, logger_1.getLogger)({ service: "sipnet", filePath: __filename });
-function createNumber(api, checkNumberPreconditions) {
+function createNumber(api, checkNumberPreconditions, routing, checkRefs) {
     const fn = (call, callback) => __awaiter(this, void 0, void 0, function* () {
         const { request } = call;
-        // Validates that the appRef or agentAor exists in the system
-        yield checkNumberPreconditions(request);
         const accessKeyId = (0, common_1.getAccessKeyIdFromCall)(call);
+        // Validates that the appRef exists in the caller's workspace (RV-B4)
+        yield checkNumberPreconditions(Object.assign(Object.assign({}, request), { accessKeyId }));
+        // ...and the trunk too (H7)
+        yield (checkRefs === null || checkRefs === void 0 ? void 0 : checkRefs(accessKeyId, (0, checkRefs_1.numberRefs)(request)));
         logger.verbose("call to createNumber", Object.assign(Object.assign({}, request), { accessKeyId }));
-        const response = yield api.createNumber((0, convertToRoutrNumber_1.convertToRoutrNumber)(request, accessKeyId));
+        const appPeerAor = routing && request.appRef
+            ? yield routing.aorFor({
+                appRef: request.appRef,
+                telUrl: request.telUrl
+            })
+            : undefined;
+        const response = yield api.createNumber((0, convertToRoutrNumber_1.convertToRoutrNumber)(request, accessKeyId, appPeerAor));
         callback(null, response);
     });
     return (0, common_1.withErrorHandlingAndValidation)(fn, common_1.Validators.createNumberRequestSchema);

package/dist/numbers/engineRouting.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Where app-linked numbers point (add-roomr 4.1). Asterisk is retired (cleanbreak CB-B3):
+ * every app-linked number goes to the roomr peer that Go Roomr nodes register under with
+ * least-sessions. `rebuild` is the only engine left; the type stays so repoint reports keep
+ * their shape.
+ */
+export type VoiceEngine = "rebuild";
+export type EngineRoutingConfig = {
+    /** The roomr peer AOR (default sip:roomr@default). */
+    roomrNodeAor?: string;
+};
+export declare const ROOMR_PEER_AOR = "sip:roomr@default";
+/** The AOR of the retired Asterisk peer, for moving numbers created before the rebuild. */
+export declare const LEGACY_ASTERISK_PEER_AOR = "sip:voice@default";
+export type NumberRouting = {
+    /** The engine for an app-linked number. */
+    engineFor(target: {
+        appRef: string;
+        telUrl?: string;
+    }): Promise<VoiceEngine>;
+    /** The peer AOR (Number.aorLink) for an app-linked number. */
+    aorFor(target: {
+        appRef: string;
+        telUrl?: string;
+    }): Promise<string>;
+    /** The peer AOR of an engine. */
+    aorOf(engine: VoiceEngine): string;
+};
+export declare function createNumberRouting(config?: EngineRoutingConfig): NumberRouting;

package/dist/numbers/engineRouting.js

@@ -0,0 +1,44 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LEGACY_ASTERISK_PEER_AOR = exports.ROOMR_PEER_AOR = void 0;
+exports.createNumberRouting = createNumberRouting;
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+const common_1 = require("@fonoster/common");
+exports.ROOMR_PEER_AOR = common_1.ROUTR_DEFAULT_PEER_AOR;
+/** The AOR of the retired Asterisk peer, for moving numbers created before the rebuild. */
+exports.LEGACY_ASTERISK_PEER_AOR = "sip:voice@default";
+function createNumberRouting(config = {}) {
+    var _a;
+    const aor = (_a = config.roomrNodeAor) !== null && _a !== void 0 ? _a : exports.ROOMR_PEER_AOR;
+    return {
+        engineFor: () => __awaiter(this, void 0, void 0, function* () { return "rebuild"; }),
+        aorFor: () => __awaiter(this, void 0, void 0, function* () { return aor; }),
+        aorOf: () => aor
+    };
+}

package/dist/numbers/getNumber.d.ts

@@ -1,22 +1,3 @@
-/**
- * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
- * http://github.com/fonoster/fonoster
- *
- * This file is part of Fonoster
- *
- * Licensed under the MIT License (the "License");
- * you may not use this file except in compliance with
- * the License. You may obtain a copy of the License at
- *
- *    https://opensource.org/licenses/MIT
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import { GrpcErrorMessage } from "@fonoster/common";
 import { NumbersApi } from "@fonoster/types";
 declare function getNumber(api: NumbersApi): (call: {
     request: unknown;

package/dist/numbers/getNumber.js

@@ -29,16 +29,16 @@ exports.getNumber = getNumber;
  * limitations under the License.
  */
 const common_1 = require("@fonoster/common");
+const identity_1 = require("@fonoster/identity");
 const logger_1 = require("@fonoster/logger");
 const convertToFonosterNumber_1 = require("./convertToFonosterNumber");
 const logger = (0, logger_1.getLogger)({ service: "sipnet", filePath: __filename });
 function getNumber(api) {
-    const fn = (call, callback) => __awaiter(this, void 0, void 0, function* () {
-        const { request } = call;
-        const { ref } = request;
+    const fn = (call) => __awaiter(this, void 0, void 0, function* () {
+        const { ref } = call.request;
         logger.verbose("call to getNumber", { ref });
-        const response = yield api.getNumber(ref);
-        callback(null, (0, convertToFonosterNumber_1.convertToFonosterNumber)(response));
+        return (0, convertToFonosterNumber_1.convertToFonosterNumber)(yield api.getNumber(ref));
     });
-    return (0, common_1.withErrorHandlingAndValidation)(fn, common_1.Validators.emptySchema);
+    // Only the caller's own numbers can be read, like every other resource.
+    return (0, common_1.withErrorHandlingAndValidation)((0, identity_1.withAccess)(fn, ((ref) => api.getNumber(ref))), common_1.Validators.emptySchema);
 }

package/dist/numbers/index.d.ts

@@ -17,3 +17,5 @@
  * limitations under the License.
  */
 export { buildService as buildNumbersService } from "./buildService";
+export * from "./engineRouting";
+export * from "./repointNumbers";

package/dist/numbers/index.js

@@ -1,4 +1,18 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildNumbersService = void 0;
 /**
@@ -21,3 +35,5 @@ exports.buildNumbersService = void 0;
  */
 var buildService_1 = require("./buildService");
 Object.defineProperty(exports, "buildNumbersService", { enumerable: true, get: function () { return buildService_1.buildService; } });
+__exportStar(require("./engineRouting"), exports);
+__exportStar(require("./repointNumbers"), exports);

package/dist/numbers/repointNumbers.d.ts

@@ -0,0 +1,49 @@
+import { NumberRouting, VoiceEngine } from "./engineRouting";
+/** The slice of Routr's Numbers API that repointing needs (`new SDK.Numbers(...)` fits). */
+export type RoutrNumbersClient = {
+    listNumbers(request: {
+        pageSize: number;
+        pageToken?: string;
+    }): Promise<{
+        items: RoutrNumber[];
+        nextPageToken?: string;
+    }>;
+    updateNumber(request: {
+        ref: string;
+        name: string;
+        aorLink: string;
+        extraHeaders?: {
+            name: string;
+            value: string;
+        }[];
+    }): Promise<unknown>;
+};
+export type RoutrNumber = {
+    ref: string;
+    name: string;
+    telUrl: string;
+    aorLink?: string;
+    extraHeaders?: {
+        name: string;
+        value: string;
+    }[];
+};
+export type RepointChange = {
+    ref: string;
+    telUrl: string;
+    appRef: string;
+    engine: VoiceEngine;
+    from?: string;
+    to: string;
+};
+/**
+ * Moves app-linked Numbers to the peer routing says (the Roomr nodes). Routr stores `aorLink` on
+ * each Number, so numbers created for Asterisk keep pointing at it until they are rewritten;
+ * agent-linked Numbers are never touched. Returns what changed (or would,
+ * with `dryRun`).
+ */
+export declare function repointNumbers(client: RoutrNumbersClient, routing: NumberRouting, options?: {
+    appRefs?: string[];
+    dryRun?: boolean;
+    pageSize?: number;
+}): Promise<RepointChange[]>;

package/dist/numbers/repointNumbers.js

@@ -0,0 +1,83 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.repointNumbers = repointNumbers;
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+const common_1 = require("@fonoster/common");
+/**
+ * Moves app-linked Numbers to the peer routing says (the Roomr nodes). Routr stores `aorLink` on
+ * each Number, so numbers created for Asterisk keep pointing at it until they are rewritten;
+ * agent-linked Numbers are never touched. Returns what changed (or would,
+ * with `dryRun`).
+ */
+function repointNumbers(client_1, routing_1) {
+    return __awaiter(this, arguments, void 0, function* (client, routing, options = {}) {
+        var _a, _b, _c;
+        const changes = [];
+        let pageToken;
+        const numbers = [];
+        do {
+            const page = yield client.listNumbers({
+                pageSize: (_a = options.pageSize) !== null && _a !== void 0 ? _a : 100,
+                pageToken
+            });
+            numbers.push(...page.items);
+            pageToken = page.nextPageToken || undefined;
+        } while (pageToken);
+        for (const n of numbers) {
+            // Header names are case-insensitive (sipnet writes x-app-ref; operators may write X-App-Ref).
+            const appRef = (_c = (_b = n.extraHeaders) === null || _b === void 0 ? void 0 : _b.find((h) => h.name.toLowerCase() === common_1.APP_REF_HEADER.toLowerCase())) === null || _c === void 0 ? void 0 : _c.value;
+            if (!appRef)
+                continue;
+            if (options.appRefs && !options.appRefs.includes(appRef))
+                continue;
+            const engine = yield routing.engineFor({ appRef, telUrl: n.telUrl });
+            const to = routing.aorOf(engine);
+            if (n.aorLink === to)
+                continue;
+            changes.push({
+                ref: n.ref,
+                telUrl: n.telUrl,
+                appRef,
+                engine,
+                from: n.aorLink,
+                to
+            });
+            if (!options.dryRun) {
+                // Routr's update needs the name; extra headers are kept as they are.
+                yield client.updateNumber({
+                    ref: n.ref,
+                    name: n.name,
+                    aorLink: to,
+                    extraHeaders: n.extraHeaders
+                });
+            }
+        }
+        return changes;
+    });
+}

package/dist/numbers/repointNumbersCli.d.ts

@@ -0,0 +1 @@
+export {};