glitchgrab 1.67.0 → 1.68.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +60 -1
- package/dist/index.d.mts +2 -2
- package/dist/index.d.ts +2 -2
- package/dist/index.js +249 -18
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +249 -18
- package/dist/index.mjs.map +1 -1
- package/dist/server.d.mts +95 -10
- package/dist/server.d.ts +95 -10
- package/dist/server.js +244 -2
- package/dist/server.js.map +1 -1
- package/dist/server.mjs +241 -2
- package/dist/server.mjs.map +1 -1
- package/dist/{types-Dw587jLi.d.mts → types-Dadt801V.d.mts} +13 -0
- package/dist/{types-Dw587jLi.d.ts → types-Dadt801V.d.ts} +13 -0
- package/package.json +1 -1
package/dist/server.d.mts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { n as ReportType, m as ReportSeverity, l as ReportResult } from './types-
|
|
1
|
+
import { n as ReportType, m as ReportSeverity, l as ReportResult } from './types-Dadt801V.mjs';
|
|
2
2
|
import 'react';
|
|
3
3
|
|
|
4
4
|
/** Who to attribute the report to. A server has no signed-in user, so this is the job or service. */
|
|
@@ -97,6 +97,12 @@ interface CaptureServerErrorsOptions extends ServerReportOptions {
|
|
|
97
97
|
* to decide).
|
|
98
98
|
*/
|
|
99
99
|
captureUnhandledRejections?: boolean;
|
|
100
|
+
/**
|
|
101
|
+
* Also file the server's `console.error` / `console.warn` lines (see
|
|
102
|
+
* {@link captureServerConsole}). Default `["error", "warn"]`; `false` turns
|
|
103
|
+
* it off.
|
|
104
|
+
*/
|
|
105
|
+
console?: ("error" | "warn")[] | false;
|
|
100
106
|
}
|
|
101
107
|
/**
|
|
102
108
|
* Report every uncaught exception and unhandled rejection in this process.
|
|
@@ -109,6 +115,61 @@ interface CaptureServerErrorsOptions extends ServerReportOptions {
|
|
|
109
115
|
* that keeps a broken process alive is worse than no reporter.
|
|
110
116
|
*/
|
|
111
117
|
declare function captureServerErrors(options?: CaptureServerErrorsOptions): () => void;
|
|
118
|
+
/** The request as Next.js passes it to `onRequestError`. */
|
|
119
|
+
interface NextRequestErrorRequest {
|
|
120
|
+
path: string;
|
|
121
|
+
method: string;
|
|
122
|
+
headers?: Record<string, string | string[] | undefined>;
|
|
123
|
+
}
|
|
124
|
+
/** The route as Next.js passes it to `onRequestError`. */
|
|
125
|
+
interface NextRequestErrorContext {
|
|
126
|
+
routerKind?: "Pages Router" | "App Router" | string;
|
|
127
|
+
/** The route file, e.g. `/app/api/users/[id]/route`. Ids are not filled in. */
|
|
128
|
+
routePath?: string;
|
|
129
|
+
routeType?: "render" | "route" | "action" | "middleware" | "proxy" | string;
|
|
130
|
+
renderSource?: string;
|
|
131
|
+
revalidateReason?: string;
|
|
132
|
+
renderType?: string;
|
|
133
|
+
}
|
|
134
|
+
/**
|
|
135
|
+
* File an error Next.js caught in a page, route handler, server action or
|
|
136
|
+
* proxy/middleware. Next catches these itself and only prints them, so neither
|
|
137
|
+
* `window.onerror` nor {@link captureServerErrors} ever sees them.
|
|
138
|
+
*
|
|
139
|
+
* ```ts
|
|
140
|
+
* // instrumentation.ts
|
|
141
|
+
* export async function onRequestError(...args: Parameters<typeof import("glitchgrab/server").reportRequestError>) {
|
|
142
|
+
* if (process.env.NEXT_RUNTIME !== "nodejs") return;
|
|
143
|
+
* const { reportRequestError } = await import("glitchgrab/server");
|
|
144
|
+
* await reportRequestError(...args);
|
|
145
|
+
* }
|
|
146
|
+
* ```
|
|
147
|
+
*
|
|
148
|
+
* Grouped per route FILE (`routePath`), not per URL, so `/api/users/42` and
|
|
149
|
+
* `/api/users/97` throwing the same error are one issue. Client hang-ups
|
|
150
|
+
* (`ECONNRESET`, `aborted`) are skipped. Never throws.
|
|
151
|
+
*/
|
|
152
|
+
declare function reportRequestError(error: unknown, request: NextRequestErrorRequest, context?: NextRequestErrorContext, options?: ServerReportOptions): Promise<ReportResult | null>;
|
|
153
|
+
/** Options for {@link captureServerConsole}. */
|
|
154
|
+
interface CaptureServerConsoleOptions extends ServerReportOptions {
|
|
155
|
+
/** Which console levels become issues. Default `["error"]`. */
|
|
156
|
+
levels?: ("error" | "warn")[];
|
|
157
|
+
/** Skip lines matching any of these. String = substring, RegExp = `.test()`. */
|
|
158
|
+
ignore?: (string | RegExp)[];
|
|
159
|
+
}
|
|
160
|
+
/**
|
|
161
|
+
* File `console.error` (and optionally `console.warn`) lines printed by the
|
|
162
|
+
* server as issues — the "something failed but nothing threw" lines a team
|
|
163
|
+
* only ever sees by tailing logs. Call once at boot, from `register()` in
|
|
164
|
+
* `instrumentation.ts`. Returns a function that puts the console back.
|
|
165
|
+
*
|
|
166
|
+
* Production only unless `enableInDevelopment`. One issue per distinct message
|
|
167
|
+
* and context: repeats within 5 minutes are dropped here, and the API comments
|
|
168
|
+
* later repeats onto the open issue. Errors `onRequestError` already filed and
|
|
169
|
+
* client hang-ups (`ECONNRESET`) are skipped. Never throws, and the original
|
|
170
|
+
* line is always printed first.
|
|
171
|
+
*/
|
|
172
|
+
declare function captureServerConsole(options?: CaptureServerConsoleOptions): () => void;
|
|
112
173
|
/** Options for {@link signSession}. */
|
|
113
174
|
interface SignSessionOptions {
|
|
114
175
|
/** Your user's id — the same value you pass as `session.userId`. */
|
|
@@ -711,12 +772,17 @@ interface FollowUp {
|
|
|
711
772
|
lastNoteAt: string | null;
|
|
712
773
|
lastNoteBy: string | null;
|
|
713
774
|
noteCount: number;
|
|
775
|
+
/** Every call to this customer, missed and inbound too. Only `listFollowUps` fills it; null elsewhere or on an older Glitchgrab. */
|
|
776
|
+
callCount: number | null;
|
|
777
|
+
/** The calls somebody answered, and their talk time in seconds (same scope as `callCount`). */
|
|
778
|
+
talkedCount: number | null;
|
|
779
|
+
talkSec: number | null;
|
|
714
780
|
lastCall: {
|
|
715
781
|
id: string;
|
|
716
782
|
status: string | null;
|
|
717
783
|
at: string;
|
|
718
784
|
durationSec: number | null;
|
|
719
|
-
/** Which of the operator's phones the call is on: 0 = the one picked, 1+
|
|
785
|
+
/** Which of the operator's phones the call is on: 0 = the one picked. Outbound never rings a backup, so 1+ only on calls before abhyasika#1141. */
|
|
720
786
|
ringingIndex: number | null;
|
|
721
787
|
/** That phone. While `status` is "DIALING" it is the one ringing right now. */
|
|
722
788
|
ringingPhone: string | null;
|
|
@@ -757,15 +823,15 @@ interface FollowUpCall {
|
|
|
757
823
|
direction: string | null;
|
|
758
824
|
at: string;
|
|
759
825
|
durationSec: number | null;
|
|
760
|
-
/** Which of the operator's phones the call is on: 0 = the one picked, 1+
|
|
826
|
+
/** Which of the operator's phones the call is on: 0 = the one picked. Outbound never rings a backup, so 1+ only on calls before abhyasika#1141. */
|
|
761
827
|
ringingIndex: number | null;
|
|
762
828
|
/** That phone. While `status` is "DIALING" it is the one ringing right now. */
|
|
763
829
|
ringingPhone: string | null;
|
|
764
830
|
/** E.164 number the call rang — `toPhone` when the dial sent one, else the follow-up's phone (#666). */
|
|
765
831
|
to: string | null;
|
|
766
832
|
/**
|
|
767
|
-
* Who didn't pick up a NO_ANSWER outbound call (#666): "operator" =
|
|
768
|
-
*
|
|
833
|
+
* Who didn't pick up a NO_ANSWER outbound call (#666): "operator" = the
|
|
834
|
+
* operator's phone that rang (never a backup), "customer" = the operator
|
|
769
835
|
* answered and the customer didn't. Null otherwise, and on older calls.
|
|
770
836
|
*/
|
|
771
837
|
missedBy: "operator" | "customer" | null;
|
|
@@ -776,6 +842,12 @@ interface FollowUpCall {
|
|
|
776
842
|
overview: string | null;
|
|
777
843
|
/** Presigned; expires after `linksExpireInSeconds`. Null when not shared. */
|
|
778
844
|
recordingUrl: string | null;
|
|
845
|
+
/**
|
|
846
|
+
* When the "From the call" note was written, and with it the next call
|
|
847
|
+
* booked or suggested. Null until then: it lands a few minutes after
|
|
848
|
+
* `overview`, so refresh the booking on this, not on the summary.
|
|
849
|
+
*/
|
|
850
|
+
fromCallNoteAt: string | null;
|
|
779
851
|
}
|
|
780
852
|
interface FollowUpDetail extends FollowUp {
|
|
781
853
|
notes: FollowUpNote[];
|
|
@@ -875,9 +947,9 @@ declare function setFollowUpBooking(externalId: string, booking: {
|
|
|
875
947
|
* operator is asked on WhatsApp to keep or remove it. `businessName` (the
|
|
876
948
|
* customer's business) is named in that reason. Never throws.
|
|
877
949
|
*
|
|
878
|
-
* `ringPhone` picks which of the operator's verified phones rings
|
|
879
|
-
*
|
|
880
|
-
* phone
|
|
950
|
+
* `ringPhone` picks which of the operator's verified phones rings (list them
|
|
951
|
+
* with {@link getOperatorRingNumbers}); omitted = their Default. Only that
|
|
952
|
+
* phone rings: not picked up → NO_ANSWER, never a backup (abhyasika#1141). A
|
|
881
953
|
* refusal carries `code` — see {@link RingErrorCode}.
|
|
882
954
|
*
|
|
883
955
|
* `toPhone` dials another number for this one call and leaves the follow-up's
|
|
@@ -902,7 +974,7 @@ interface OperatorRingNumber {
|
|
|
902
974
|
phone: string;
|
|
903
975
|
label: string | null;
|
|
904
976
|
isDefault: boolean;
|
|
905
|
-
/** 0 = Default, then backups
|
|
977
|
+
/** 0 = Default, then backups. A call you place rings only the one picked; incoming calls ring backups after Defaults. */
|
|
906
978
|
order: number;
|
|
907
979
|
}
|
|
908
980
|
type OperatorRingNumbersResult = {
|
|
@@ -1176,6 +1248,19 @@ declare function enableCalling(params: {
|
|
|
1176
1248
|
declare function disableCalling(params: {
|
|
1177
1249
|
ownerId: string;
|
|
1178
1250
|
}, options?: CallsOptions): Promise<LineRequestResult>;
|
|
1251
|
+
/**
|
|
1252
|
+
* The firm wants a different number (practice-stack #3221). Glitchgrab rents a
|
|
1253
|
+
* new one under the same KYC, points the firm's SAME line at it (callers, call
|
|
1254
|
+
* log and consent stay), then releases the old number; the rent is unchanged.
|
|
1255
|
+
* `phone.line_ready` fires with the new number. `areaCode` = STD code to search
|
|
1256
|
+
* under, else the firm's last choice. Refusals carry `code`: `NO_REQUEST`,
|
|
1257
|
+
* `NO_LINE` (no live number yet), `BUSY` (a change is running), `PROVIDER`.
|
|
1258
|
+
* Renting can take ~30 s: pass a longer `timeoutMs`. Never throws.
|
|
1259
|
+
*/
|
|
1260
|
+
declare function changeLineNumber(params: {
|
|
1261
|
+
ownerId: string;
|
|
1262
|
+
areaCode?: string;
|
|
1263
|
+
}, options?: CallsOptions): Promise<LineRequestResult>;
|
|
1179
1264
|
interface RegisteredWebhook {
|
|
1180
1265
|
id: string;
|
|
1181
1266
|
url: string;
|
|
@@ -1290,4 +1375,4 @@ declare function testRingNumber(id: string, options?: LineCallsOptions): Promise
|
|
|
1290
1375
|
verified: boolean;
|
|
1291
1376
|
}>>;
|
|
1292
1377
|
|
|
1293
|
-
export { type Booking, type BookingAnswer, type BookingClientNotice, type BookingMutationResult, type BookingNotifyRecipient, type BookingQuestion, type BookingQuestionInput, type BookingSettings, type BookingSettingsChanges, type BookingSettingsResult, type BookingSettingsState, type BookingWorkingHours, type Call, type CallAudio, type CallIssueSessionOptions, type CallIssueSessionResult, type CallListItem, type CallMoment, type CallParticipant, type CallWebhook, type CallsOptions, type CaptureServerErrorsOptions, type DeleteCallResult, type FollowUp, type FollowUpBooking, type FollowUpCall, type FollowUpDetail, type FollowUpDue, type FollowUpNote, type FollowUpOperator, type FollowUpWriteResult, type GetCallOptions, type Guide, type GuideReadOptions, type GuideSummary, type Lead, type LineCallerResult, type LineCallsOptions, type LineRequestResult, type ListBookingsOptions, type ListCallsOptions, type ListLeadsOptions, type OperatorRingNumber, type OperatorRingNumbersResult, type PhoneLineInfo, type PhoneLineRequest, type PhoneLineStatus, type PhoneLineWebhook, type PlaceCallResult, type RegisteredWebhook, ReportResult, ReportSeverity, ReportType, type RingErrorCode, type RingNumber, type RingNumberList, type RingNumberWriteResult, type ServerReportOptions, type ServerReporterConfig, type ServerReporterIdentity, type SignSessionOptions, addFollowUpNote, addLineCaller, addRingNumber, cancelBooking, captureServerErrors, configureServerReporter, createCallIssueSession, deleteCall, dialFollowUp, disableCalling, discardBookingQuestionsDraft, editFollowUpNote, enableCalling, escapeJsonForScript, getBookingSettings, getCall, getFollowUp, getGuide, getOperatorRingNumbers, getPhoneLine, listBookings, listCalls, listFollowUps, listGuides, listLeads, listRingNumbers, listWebhooks, placeCall, publishBookingQuestions, registerWebhook, removeLineCaller, removeRingNumber, removeWebhook, reportServerError, rescheduleBooking, resetServerReporter, setFollowUpBooking, signSession, submitPhoneKyc, testRingNumber, updateBookingSettings, updateRingNumber };
|
|
1378
|
+
export { type Booking, type BookingAnswer, type BookingClientNotice, type BookingMutationResult, type BookingNotifyRecipient, type BookingQuestion, type BookingQuestionInput, type BookingSettings, type BookingSettingsChanges, type BookingSettingsResult, type BookingSettingsState, type BookingWorkingHours, type Call, type CallAudio, type CallIssueSessionOptions, type CallIssueSessionResult, type CallListItem, type CallMoment, type CallParticipant, type CallWebhook, type CallsOptions, type CaptureServerConsoleOptions, type CaptureServerErrorsOptions, type DeleteCallResult, type FollowUp, type FollowUpBooking, type FollowUpCall, type FollowUpDetail, type FollowUpDue, type FollowUpNote, type FollowUpOperator, type FollowUpWriteResult, type GetCallOptions, type Guide, type GuideReadOptions, type GuideSummary, type Lead, type LineCallerResult, type LineCallsOptions, type LineRequestResult, type ListBookingsOptions, type ListCallsOptions, type ListLeadsOptions, type NextRequestErrorContext, type NextRequestErrorRequest, type OperatorRingNumber, type OperatorRingNumbersResult, type PhoneLineInfo, type PhoneLineRequest, type PhoneLineStatus, type PhoneLineWebhook, type PlaceCallResult, type RegisteredWebhook, ReportResult, ReportSeverity, ReportType, type RingErrorCode, type RingNumber, type RingNumberList, type RingNumberWriteResult, type ServerReportOptions, type ServerReporterConfig, type ServerReporterIdentity, type SignSessionOptions, addFollowUpNote, addLineCaller, addRingNumber, cancelBooking, captureServerConsole, captureServerErrors, changeLineNumber, configureServerReporter, createCallIssueSession, deleteCall, dialFollowUp, disableCalling, discardBookingQuestionsDraft, editFollowUpNote, enableCalling, escapeJsonForScript, getBookingSettings, getCall, getFollowUp, getGuide, getOperatorRingNumbers, getPhoneLine, listBookings, listCalls, listFollowUps, listGuides, listLeads, listRingNumbers, listWebhooks, placeCall, publishBookingQuestions, registerWebhook, removeLineCaller, removeRingNumber, removeWebhook, reportRequestError, reportServerError, rescheduleBooking, resetServerReporter, setFollowUpBooking, signSession, submitPhoneKyc, testRingNumber, updateBookingSettings, updateRingNumber };
|
package/dist/server.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { n as ReportType, m as ReportSeverity, l as ReportResult } from './types-
|
|
1
|
+
import { n as ReportType, m as ReportSeverity, l as ReportResult } from './types-Dadt801V.js';
|
|
2
2
|
import 'react';
|
|
3
3
|
|
|
4
4
|
/** Who to attribute the report to. A server has no signed-in user, so this is the job or service. */
|
|
@@ -97,6 +97,12 @@ interface CaptureServerErrorsOptions extends ServerReportOptions {
|
|
|
97
97
|
* to decide).
|
|
98
98
|
*/
|
|
99
99
|
captureUnhandledRejections?: boolean;
|
|
100
|
+
/**
|
|
101
|
+
* Also file the server's `console.error` / `console.warn` lines (see
|
|
102
|
+
* {@link captureServerConsole}). Default `["error", "warn"]`; `false` turns
|
|
103
|
+
* it off.
|
|
104
|
+
*/
|
|
105
|
+
console?: ("error" | "warn")[] | false;
|
|
100
106
|
}
|
|
101
107
|
/**
|
|
102
108
|
* Report every uncaught exception and unhandled rejection in this process.
|
|
@@ -109,6 +115,61 @@ interface CaptureServerErrorsOptions extends ServerReportOptions {
|
|
|
109
115
|
* that keeps a broken process alive is worse than no reporter.
|
|
110
116
|
*/
|
|
111
117
|
declare function captureServerErrors(options?: CaptureServerErrorsOptions): () => void;
|
|
118
|
+
/** The request as Next.js passes it to `onRequestError`. */
|
|
119
|
+
interface NextRequestErrorRequest {
|
|
120
|
+
path: string;
|
|
121
|
+
method: string;
|
|
122
|
+
headers?: Record<string, string | string[] | undefined>;
|
|
123
|
+
}
|
|
124
|
+
/** The route as Next.js passes it to `onRequestError`. */
|
|
125
|
+
interface NextRequestErrorContext {
|
|
126
|
+
routerKind?: "Pages Router" | "App Router" | string;
|
|
127
|
+
/** The route file, e.g. `/app/api/users/[id]/route`. Ids are not filled in. */
|
|
128
|
+
routePath?: string;
|
|
129
|
+
routeType?: "render" | "route" | "action" | "middleware" | "proxy" | string;
|
|
130
|
+
renderSource?: string;
|
|
131
|
+
revalidateReason?: string;
|
|
132
|
+
renderType?: string;
|
|
133
|
+
}
|
|
134
|
+
/**
|
|
135
|
+
* File an error Next.js caught in a page, route handler, server action or
|
|
136
|
+
* proxy/middleware. Next catches these itself and only prints them, so neither
|
|
137
|
+
* `window.onerror` nor {@link captureServerErrors} ever sees them.
|
|
138
|
+
*
|
|
139
|
+
* ```ts
|
|
140
|
+
* // instrumentation.ts
|
|
141
|
+
* export async function onRequestError(...args: Parameters<typeof import("glitchgrab/server").reportRequestError>) {
|
|
142
|
+
* if (process.env.NEXT_RUNTIME !== "nodejs") return;
|
|
143
|
+
* const { reportRequestError } = await import("glitchgrab/server");
|
|
144
|
+
* await reportRequestError(...args);
|
|
145
|
+
* }
|
|
146
|
+
* ```
|
|
147
|
+
*
|
|
148
|
+
* Grouped per route FILE (`routePath`), not per URL, so `/api/users/42` and
|
|
149
|
+
* `/api/users/97` throwing the same error are one issue. Client hang-ups
|
|
150
|
+
* (`ECONNRESET`, `aborted`) are skipped. Never throws.
|
|
151
|
+
*/
|
|
152
|
+
declare function reportRequestError(error: unknown, request: NextRequestErrorRequest, context?: NextRequestErrorContext, options?: ServerReportOptions): Promise<ReportResult | null>;
|
|
153
|
+
/** Options for {@link captureServerConsole}. */
|
|
154
|
+
interface CaptureServerConsoleOptions extends ServerReportOptions {
|
|
155
|
+
/** Which console levels become issues. Default `["error"]`. */
|
|
156
|
+
levels?: ("error" | "warn")[];
|
|
157
|
+
/** Skip lines matching any of these. String = substring, RegExp = `.test()`. */
|
|
158
|
+
ignore?: (string | RegExp)[];
|
|
159
|
+
}
|
|
160
|
+
/**
|
|
161
|
+
* File `console.error` (and optionally `console.warn`) lines printed by the
|
|
162
|
+
* server as issues — the "something failed but nothing threw" lines a team
|
|
163
|
+
* only ever sees by tailing logs. Call once at boot, from `register()` in
|
|
164
|
+
* `instrumentation.ts`. Returns a function that puts the console back.
|
|
165
|
+
*
|
|
166
|
+
* Production only unless `enableInDevelopment`. One issue per distinct message
|
|
167
|
+
* and context: repeats within 5 minutes are dropped here, and the API comments
|
|
168
|
+
* later repeats onto the open issue. Errors `onRequestError` already filed and
|
|
169
|
+
* client hang-ups (`ECONNRESET`) are skipped. Never throws, and the original
|
|
170
|
+
* line is always printed first.
|
|
171
|
+
*/
|
|
172
|
+
declare function captureServerConsole(options?: CaptureServerConsoleOptions): () => void;
|
|
112
173
|
/** Options for {@link signSession}. */
|
|
113
174
|
interface SignSessionOptions {
|
|
114
175
|
/** Your user's id — the same value you pass as `session.userId`. */
|
|
@@ -711,12 +772,17 @@ interface FollowUp {
|
|
|
711
772
|
lastNoteAt: string | null;
|
|
712
773
|
lastNoteBy: string | null;
|
|
713
774
|
noteCount: number;
|
|
775
|
+
/** Every call to this customer, missed and inbound too. Only `listFollowUps` fills it; null elsewhere or on an older Glitchgrab. */
|
|
776
|
+
callCount: number | null;
|
|
777
|
+
/** The calls somebody answered, and their talk time in seconds (same scope as `callCount`). */
|
|
778
|
+
talkedCount: number | null;
|
|
779
|
+
talkSec: number | null;
|
|
714
780
|
lastCall: {
|
|
715
781
|
id: string;
|
|
716
782
|
status: string | null;
|
|
717
783
|
at: string;
|
|
718
784
|
durationSec: number | null;
|
|
719
|
-
/** Which of the operator's phones the call is on: 0 = the one picked, 1+
|
|
785
|
+
/** Which of the operator's phones the call is on: 0 = the one picked. Outbound never rings a backup, so 1+ only on calls before abhyasika#1141. */
|
|
720
786
|
ringingIndex: number | null;
|
|
721
787
|
/** That phone. While `status` is "DIALING" it is the one ringing right now. */
|
|
722
788
|
ringingPhone: string | null;
|
|
@@ -757,15 +823,15 @@ interface FollowUpCall {
|
|
|
757
823
|
direction: string | null;
|
|
758
824
|
at: string;
|
|
759
825
|
durationSec: number | null;
|
|
760
|
-
/** Which of the operator's phones the call is on: 0 = the one picked, 1+
|
|
826
|
+
/** Which of the operator's phones the call is on: 0 = the one picked. Outbound never rings a backup, so 1+ only on calls before abhyasika#1141. */
|
|
761
827
|
ringingIndex: number | null;
|
|
762
828
|
/** That phone. While `status` is "DIALING" it is the one ringing right now. */
|
|
763
829
|
ringingPhone: string | null;
|
|
764
830
|
/** E.164 number the call rang — `toPhone` when the dial sent one, else the follow-up's phone (#666). */
|
|
765
831
|
to: string | null;
|
|
766
832
|
/**
|
|
767
|
-
* Who didn't pick up a NO_ANSWER outbound call (#666): "operator" =
|
|
768
|
-
*
|
|
833
|
+
* Who didn't pick up a NO_ANSWER outbound call (#666): "operator" = the
|
|
834
|
+
* operator's phone that rang (never a backup), "customer" = the operator
|
|
769
835
|
* answered and the customer didn't. Null otherwise, and on older calls.
|
|
770
836
|
*/
|
|
771
837
|
missedBy: "operator" | "customer" | null;
|
|
@@ -776,6 +842,12 @@ interface FollowUpCall {
|
|
|
776
842
|
overview: string | null;
|
|
777
843
|
/** Presigned; expires after `linksExpireInSeconds`. Null when not shared. */
|
|
778
844
|
recordingUrl: string | null;
|
|
845
|
+
/**
|
|
846
|
+
* When the "From the call" note was written, and with it the next call
|
|
847
|
+
* booked or suggested. Null until then: it lands a few minutes after
|
|
848
|
+
* `overview`, so refresh the booking on this, not on the summary.
|
|
849
|
+
*/
|
|
850
|
+
fromCallNoteAt: string | null;
|
|
779
851
|
}
|
|
780
852
|
interface FollowUpDetail extends FollowUp {
|
|
781
853
|
notes: FollowUpNote[];
|
|
@@ -875,9 +947,9 @@ declare function setFollowUpBooking(externalId: string, booking: {
|
|
|
875
947
|
* operator is asked on WhatsApp to keep or remove it. `businessName` (the
|
|
876
948
|
* customer's business) is named in that reason. Never throws.
|
|
877
949
|
*
|
|
878
|
-
* `ringPhone` picks which of the operator's verified phones rings
|
|
879
|
-
*
|
|
880
|
-
* phone
|
|
950
|
+
* `ringPhone` picks which of the operator's verified phones rings (list them
|
|
951
|
+
* with {@link getOperatorRingNumbers}); omitted = their Default. Only that
|
|
952
|
+
* phone rings: not picked up → NO_ANSWER, never a backup (abhyasika#1141). A
|
|
881
953
|
* refusal carries `code` — see {@link RingErrorCode}.
|
|
882
954
|
*
|
|
883
955
|
* `toPhone` dials another number for this one call and leaves the follow-up's
|
|
@@ -902,7 +974,7 @@ interface OperatorRingNumber {
|
|
|
902
974
|
phone: string;
|
|
903
975
|
label: string | null;
|
|
904
976
|
isDefault: boolean;
|
|
905
|
-
/** 0 = Default, then backups
|
|
977
|
+
/** 0 = Default, then backups. A call you place rings only the one picked; incoming calls ring backups after Defaults. */
|
|
906
978
|
order: number;
|
|
907
979
|
}
|
|
908
980
|
type OperatorRingNumbersResult = {
|
|
@@ -1176,6 +1248,19 @@ declare function enableCalling(params: {
|
|
|
1176
1248
|
declare function disableCalling(params: {
|
|
1177
1249
|
ownerId: string;
|
|
1178
1250
|
}, options?: CallsOptions): Promise<LineRequestResult>;
|
|
1251
|
+
/**
|
|
1252
|
+
* The firm wants a different number (practice-stack #3221). Glitchgrab rents a
|
|
1253
|
+
* new one under the same KYC, points the firm's SAME line at it (callers, call
|
|
1254
|
+
* log and consent stay), then releases the old number; the rent is unchanged.
|
|
1255
|
+
* `phone.line_ready` fires with the new number. `areaCode` = STD code to search
|
|
1256
|
+
* under, else the firm's last choice. Refusals carry `code`: `NO_REQUEST`,
|
|
1257
|
+
* `NO_LINE` (no live number yet), `BUSY` (a change is running), `PROVIDER`.
|
|
1258
|
+
* Renting can take ~30 s: pass a longer `timeoutMs`. Never throws.
|
|
1259
|
+
*/
|
|
1260
|
+
declare function changeLineNumber(params: {
|
|
1261
|
+
ownerId: string;
|
|
1262
|
+
areaCode?: string;
|
|
1263
|
+
}, options?: CallsOptions): Promise<LineRequestResult>;
|
|
1179
1264
|
interface RegisteredWebhook {
|
|
1180
1265
|
id: string;
|
|
1181
1266
|
url: string;
|
|
@@ -1290,4 +1375,4 @@ declare function testRingNumber(id: string, options?: LineCallsOptions): Promise
|
|
|
1290
1375
|
verified: boolean;
|
|
1291
1376
|
}>>;
|
|
1292
1377
|
|
|
1293
|
-
export { type Booking, type BookingAnswer, type BookingClientNotice, type BookingMutationResult, type BookingNotifyRecipient, type BookingQuestion, type BookingQuestionInput, type BookingSettings, type BookingSettingsChanges, type BookingSettingsResult, type BookingSettingsState, type BookingWorkingHours, type Call, type CallAudio, type CallIssueSessionOptions, type CallIssueSessionResult, type CallListItem, type CallMoment, type CallParticipant, type CallWebhook, type CallsOptions, type CaptureServerErrorsOptions, type DeleteCallResult, type FollowUp, type FollowUpBooking, type FollowUpCall, type FollowUpDetail, type FollowUpDue, type FollowUpNote, type FollowUpOperator, type FollowUpWriteResult, type GetCallOptions, type Guide, type GuideReadOptions, type GuideSummary, type Lead, type LineCallerResult, type LineCallsOptions, type LineRequestResult, type ListBookingsOptions, type ListCallsOptions, type ListLeadsOptions, type OperatorRingNumber, type OperatorRingNumbersResult, type PhoneLineInfo, type PhoneLineRequest, type PhoneLineStatus, type PhoneLineWebhook, type PlaceCallResult, type RegisteredWebhook, ReportResult, ReportSeverity, ReportType, type RingErrorCode, type RingNumber, type RingNumberList, type RingNumberWriteResult, type ServerReportOptions, type ServerReporterConfig, type ServerReporterIdentity, type SignSessionOptions, addFollowUpNote, addLineCaller, addRingNumber, cancelBooking, captureServerErrors, configureServerReporter, createCallIssueSession, deleteCall, dialFollowUp, disableCalling, discardBookingQuestionsDraft, editFollowUpNote, enableCalling, escapeJsonForScript, getBookingSettings, getCall, getFollowUp, getGuide, getOperatorRingNumbers, getPhoneLine, listBookings, listCalls, listFollowUps, listGuides, listLeads, listRingNumbers, listWebhooks, placeCall, publishBookingQuestions, registerWebhook, removeLineCaller, removeRingNumber, removeWebhook, reportServerError, rescheduleBooking, resetServerReporter, setFollowUpBooking, signSession, submitPhoneKyc, testRingNumber, updateBookingSettings, updateRingNumber };
|
|
1378
|
+
export { type Booking, type BookingAnswer, type BookingClientNotice, type BookingMutationResult, type BookingNotifyRecipient, type BookingQuestion, type BookingQuestionInput, type BookingSettings, type BookingSettingsChanges, type BookingSettingsResult, type BookingSettingsState, type BookingWorkingHours, type Call, type CallAudio, type CallIssueSessionOptions, type CallIssueSessionResult, type CallListItem, type CallMoment, type CallParticipant, type CallWebhook, type CallsOptions, type CaptureServerConsoleOptions, type CaptureServerErrorsOptions, type DeleteCallResult, type FollowUp, type FollowUpBooking, type FollowUpCall, type FollowUpDetail, type FollowUpDue, type FollowUpNote, type FollowUpOperator, type FollowUpWriteResult, type GetCallOptions, type Guide, type GuideReadOptions, type GuideSummary, type Lead, type LineCallerResult, type LineCallsOptions, type LineRequestResult, type ListBookingsOptions, type ListCallsOptions, type ListLeadsOptions, type NextRequestErrorContext, type NextRequestErrorRequest, type OperatorRingNumber, type OperatorRingNumbersResult, type PhoneLineInfo, type PhoneLineRequest, type PhoneLineStatus, type PhoneLineWebhook, type PlaceCallResult, type RegisteredWebhook, ReportResult, ReportSeverity, ReportType, type RingErrorCode, type RingNumber, type RingNumberList, type RingNumberWriteResult, type ServerReportOptions, type ServerReporterConfig, type ServerReporterIdentity, type SignSessionOptions, addFollowUpNote, addLineCaller, addRingNumber, cancelBooking, captureServerConsole, captureServerErrors, changeLineNumber, configureServerReporter, createCallIssueSession, deleteCall, dialFollowUp, disableCalling, discardBookingQuestionsDraft, editFollowUpNote, enableCalling, escapeJsonForScript, getBookingSettings, getCall, getFollowUp, getGuide, getOperatorRingNumbers, getPhoneLine, listBookings, listCalls, listFollowUps, listGuides, listLeads, listRingNumbers, listWebhooks, placeCall, publishBookingQuestions, registerWebhook, removeLineCaller, removeRingNumber, removeWebhook, reportRequestError, reportServerError, rescheduleBooking, resetServerReporter, setFollowUpBooking, signSession, submitPhoneKyc, testRingNumber, updateBookingSettings, updateRingNumber };
|