@arbidocs/sdk 0.5.93 → 0.5.95

package/dist/{browser-4oIgAqs1.d.cts → browser-BvaBTk7i.d.cts}

@@ -997,6 +997,13 @@ type SupportRating = _arbidocs_client.components['schemas']['SupportRating'];
 declare function listSupportTickets(arbi: ArbiClient): Promise<SupportTicket[]>;
 declare function getSupportTicket(arbi: ArbiClient, ticketId: number): Promise<SupportTicket>;
 declare function rateSupportTicket(arbi: ArbiClient, ticketId: number, rating: SupportRating): Promise<SupportTicket>;
+/** Human-facing reference; routing and idempotency continue to use the numeric id. */
+declare function supportTicketReference(deploymentDomain: string, ticketId: number): string;
+/** Upgrade legacy notification metadata using this SDK client's deployment identity. */
+declare function withSupportNotificationReference<T extends {
+    type: unknown;
+    content?: string | null;
+}>(notification: T, domain: string): T;
 
 type support_SupportRating = SupportRating;
 type support_SupportTicket = SupportTicket;
@@ -1005,8 +1012,10 @@ declare const support_createSupportTicket: typeof createSupportTicket;
 declare const support_getSupportTicket: typeof getSupportTicket;
 declare const support_listSupportTickets: typeof listSupportTickets;
 declare const support_rateSupportTicket: typeof rateSupportTicket;
+declare const support_supportTicketReference: typeof supportTicketReference;
+declare const support_withSupportNotificationReference: typeof withSupportNotificationReference;
 declare namespace support {
-  export { type support_SupportRating as SupportRating, type support_SupportTicket as SupportTicket, type support_SupportTicketInput as SupportTicketInput, support_createSupportTicket as createSupportTicket, support_getSupportTicket as getSupportTicket, support_listSupportTickets as listSupportTickets, support_rateSupportTicket as rateSupportTicket };
+  export { type support_SupportRating as SupportRating, type support_SupportTicket as SupportTicket, type support_SupportTicketInput as SupportTicketInput, support_createSupportTicket as createSupportTicket, support_getSupportTicket as getSupportTicket, support_listSupportTickets as listSupportTickets, support_rateSupportTicket as rateSupportTicket, support_supportTicketReference as supportTicketReference, support_withSupportNotificationReference as withSupportNotificationReference };
 }
 
 /**
@@ -15211,7 +15220,9 @@ declare class Arbi {
         }>;
     };
     readonly support: {
+        reference: (ticketId: number) => string;
         list: () => Promise<{
+            reference: string;
             ticket_id: number;
             title: string;
             description: string;
@@ -15222,6 +15233,7 @@ declare class Arbi {
             rating?: components["schemas"]["SupportRating"] | null;
         }[]>;
         get: (ticketId: number) => Promise<{
+            reference: string;
             ticket_id: number;
             title: string;
             description: string;
@@ -15232,6 +15244,7 @@ declare class Arbi {
             rating?: components["schemas"]["SupportRating"] | null;
         }>;
         rate: (ticketId: number, rating: SupportRating) => Promise<{
+            reference: string;
             ticket_id: number;
             title: string;
             description: string;
@@ -15242,8 +15255,8 @@ declare class Arbi {
             rating?: components["schemas"]["SupportRating"] | null;
         }>;
         create: (input: SupportTicketInput) => Promise<{
-            ticket_id: number;
             reference: string;
+            ticket_id: number;
         }>;
     };
     readonly health: {

package/dist/{browser-CL-6Y6E1.d.ts → browser-CpYezzb5.d.ts}

@@ -997,6 +997,13 @@ type SupportRating = _arbidocs_client.components['schemas']['SupportRating'];
 declare function listSupportTickets(arbi: ArbiClient): Promise<SupportTicket[]>;
 declare function getSupportTicket(arbi: ArbiClient, ticketId: number): Promise<SupportTicket>;
 declare function rateSupportTicket(arbi: ArbiClient, ticketId: number, rating: SupportRating): Promise<SupportTicket>;
+/** Human-facing reference; routing and idempotency continue to use the numeric id. */
+declare function supportTicketReference(deploymentDomain: string, ticketId: number): string;
+/** Upgrade legacy notification metadata using this SDK client's deployment identity. */
+declare function withSupportNotificationReference<T extends {
+    type: unknown;
+    content?: string | null;
+}>(notification: T, domain: string): T;
 
 type support_SupportRating = SupportRating;
 type support_SupportTicket = SupportTicket;
@@ -1005,8 +1012,10 @@ declare const support_createSupportTicket: typeof createSupportTicket;
 declare const support_getSupportTicket: typeof getSupportTicket;
 declare const support_listSupportTickets: typeof listSupportTickets;
 declare const support_rateSupportTicket: typeof rateSupportTicket;
+declare const support_supportTicketReference: typeof supportTicketReference;
+declare const support_withSupportNotificationReference: typeof withSupportNotificationReference;
 declare namespace support {
-  export { type support_SupportRating as SupportRating, type support_SupportTicket as SupportTicket, type support_SupportTicketInput as SupportTicketInput, support_createSupportTicket as createSupportTicket, support_getSupportTicket as getSupportTicket, support_listSupportTickets as listSupportTickets, support_rateSupportTicket as rateSupportTicket };
+  export { type support_SupportRating as SupportRating, type support_SupportTicket as SupportTicket, type support_SupportTicketInput as SupportTicketInput, support_createSupportTicket as createSupportTicket, support_getSupportTicket as getSupportTicket, support_listSupportTickets as listSupportTickets, support_rateSupportTicket as rateSupportTicket, support_supportTicketReference as supportTicketReference, support_withSupportNotificationReference as withSupportNotificationReference };
 }
 
 /**
@@ -15211,7 +15220,9 @@ declare class Arbi {
         }>;
     };
     readonly support: {
+        reference: (ticketId: number) => string;
         list: () => Promise<{
+            reference: string;
             ticket_id: number;
             title: string;
             description: string;
@@ -15222,6 +15233,7 @@ declare class Arbi {
             rating?: components["schemas"]["SupportRating"] | null;
         }[]>;
         get: (ticketId: number) => Promise<{
+            reference: string;
             ticket_id: number;
             title: string;
             description: string;
@@ -15232,6 +15244,7 @@ declare class Arbi {
             rating?: components["schemas"]["SupportRating"] | null;
         }>;
         rate: (ticketId: number, rating: SupportRating) => Promise<{
+            reference: string;
             ticket_id: number;
             title: string;
             description: string;
@@ -15242,8 +15255,8 @@ declare class Arbi {
             rating?: components["schemas"]["SupportRating"] | null;
         }>;
         create: (input: SupportTicketInput) => Promise<{
-            ticket_id: number;
             reference: string;
+            ticket_id: number;
         }>;
     };
     readonly health: {

package/dist/browser.cjs

@@ -4660,7 +4660,9 @@ __export(support_exports, {
   createSupportTicket: () => createSupportTicket,
   getSupportTicket: () => getSupportTicket,
   listSupportTickets: () => listSupportTickets,
-  rateSupportTicket: () => rateSupportTicket
+  rateSupportTicket: () => rateSupportTicket,
+  supportTicketReference: () => supportTicketReference,
+  withSupportNotificationReference: () => withSupportNotificationReference
 });
 
 // src/operations/mail-encoding.ts
@@ -4712,6 +4714,32 @@ async function rateSupportTicket(arbi, ticketId, rating) {
     "Could not send your rating."
   );
 }
+function supportTicketReference(deploymentDomain, ticketId) {
+  if (!Number.isSafeInteger(ticketId) || ticketId < 1)
+    throw new ArbiError("Invalid support ticket id.");
+  const domain = deploymentDomain.trim().toLowerCase();
+  if (!/^[a-z0-9][a-z0-9.-]*$/.test(domain) || domain.includes("..")) return `#${ticketId}`;
+  return `${domain.split(".")[0]}-${ticketId}`;
+}
+function withSupportNotificationReference(notification, domain) {
+  if (!["support_ticket_received", "support_ticket_reviewed", "support_ticket_resolved"].includes(
+    String(notification.type)
+  ))
+    return notification;
+  try {
+    const content = JSON.parse(notification.content ?? "{}");
+    if (!Number.isSafeInteger(content.ticket_id) || content.ticket_id < 1) return notification;
+    return {
+      ...notification,
+      content: JSON.stringify({
+        ...content,
+        ticket_reference: supportTicketReference(domain, content.ticket_id)
+      })
+    };
+  } catch {
+    return notification;
+  }
+}
 
 // src/diagnostics.ts
 async function diagnoseSetup(options) {
@@ -12440,7 +12468,9 @@ var Arbi = class {
         params: { query: { ...type ? { type } : {}, limit, ...offset ? { offset } : {} } }
       });
       if (error) throw new ArbiError("Could not load notifications");
-      return data || [];
+      return (data || []).map(
+        (notification) => withSupportNotificationReference(notification, this.getDeploymentDomain())
+      );
     },
     markRead: async (ids) => {
       if (!ids.length) return;
@@ -13497,12 +13527,24 @@ var Arbi = class {
   };
   // ── Health ────────────────────────────────────────────────────────────
   support = {
-    list: () => this.recovering(() => listSupportTickets(this.requireClient())),
-    get: (ticketId) => this.recovering(() => getSupportTicket(this.requireClient(), ticketId)),
-    rate: (ticketId, rating) => this.recovering(() => rateSupportTicket(this.requireClient(), ticketId, rating)),
+    reference: (ticketId) => supportTicketReference(this.getDeploymentDomain(), ticketId),
+    list: () => this.recovering(() => listSupportTickets(this.requireClient())).then(
+      (tickets) => tickets.map((ticket) => ({
+        ...ticket,
+        reference: this.support.reference(ticket.ticket_id)
+      }))
+    ),
+    get: (ticketId) => this.recovering(() => getSupportTicket(this.requireClient(), ticketId)).then(
+      (ticket) => ({ ...ticket, reference: this.support.reference(ticket.ticket_id) })
+    ),
+    rate: (ticketId, rating) => this.recovering(
+      () => rateSupportTicket(this.requireClient(), ticketId, rating)
+    ).then((ticket) => ({ ...ticket, reference: this.support.reference(ticket.ticket_id) })),
     create: (input) => {
       const request = { ...input, idempotencyKey: input.idempotencyKey ?? crypto.randomUUID() };
-      return this.recovering(() => createSupportTicket(this.requireClient(), request));
+      return this.recovering(
+        () => createSupportTicket(this.requireClient(), request)
+      ).then((receipt) => ({ ...receipt, reference: this.support.reference(receipt.ticket_id) }));
     }
   };
   health = {