@salsita-ai/contracts 0.0.0-stage → 0.49.0-develop.2a2e8d75e7

package/dist/webhook/excel-workbook-client.d.ts

@@ -0,0 +1,78 @@
+import { type CellValue, type ColumnMeta, type CreateSpreadsheetResult, type CreateWorkbookLocation, type LegendTabData, type SheetTabData, type SpreadsheetAdapter, type SpreadsheetFileRef, type SpreadsheetMeta } from './spreadsheet-adapter.js';
+/** Folder visible in the picker — only relevant when browsing (not searching). */
+export interface ExcelFolderRef {
+    readonly itemId: string;
+    readonly name: string;
+}
+/** Workbook the picker can select. */
+export interface ExcelWorkbookRef {
+    readonly itemId: string;
+    readonly driveId: string;
+    readonly name: string;
+    readonly webUrl: string | null;
+    readonly lastModified: string | null;
+}
+export interface ExcelListFilesResult {
+    readonly folders: readonly ExcelFolderRef[];
+    readonly files: readonly ExcelWorkbookRef[];
+}
+export interface ExcelSpreadsheetAdapterOptions {
+    /** Override for staging/test environments. Defaults to the production Microsoft Graph endpoint. */
+    readonly apiBaseUrl?: string;
+}
+export declare class ExcelSpreadsheetAdapter implements SpreadsheetAdapter {
+    private readonly _apiBaseUrl;
+    constructor(options?: ExcelSpreadsheetAdapterOptions);
+    fetchMeta: (accessToken: string, ref: SpreadsheetFileRef) => Promise<SpreadsheetMeta>;
+    /**
+     * Resolves the SharePoint `webUrl` for a workbook so the studio can render
+     * a deep link to it. Microsoft Graph returns whatever URL is appropriate
+     * for the drive the item lives in — for SharePoint drives that's the
+     * Office Online "open in browser" link (or the plain file path), not a
+     * OneDrive URL. Returns `null` when the lookup fails so the UI can fall
+     * back to the site root link.
+     */
+    fetchWebUrl: (accessToken: string, ref: SpreadsheetFileRef) => Promise<string | null>;
+    fetchTabHeaders: (accessToken: string, ref: SpreadsheetFileRef, tabName: string) => Promise<readonly string[]>;
+    fetchData: (accessToken: string, ref: SpreadsheetFileRef, tabNames: readonly string[], headerRowIndex?: number | null) => Promise<readonly SheetTabData[]>;
+    createWorkbook: (accessToken: string, title: string, headers: readonly string[], values?: ReadonlyArray<readonly CellValue[]>, columns?: readonly ColumnMeta[], dataTabName?: string, legendTab?: LegendTabData, location?: CreateWorkbookLocation) => Promise<CreateSpreadsheetResult>;
+    /**
+     * Lists folders and `.xlsx` workbooks in the SharePoint site's default
+     * document library. When `query` is non-empty, fetches root children and
+     * filters client-side — the Graph `search(q='...')` function endpoint
+     * returns 500 with `Sites.Selected` app-only auth because the SharePoint
+     * Search Service can't resolve scope without a user context (known
+     * limitation, not fixable client-side). When `parentItemId` is set (and
+     * `query` is empty), lists the children of that folder; otherwise lists
+     * the drive root.
+     *
+     * No pagination — Graph returns its first page (default 200 items).
+     * Client-side filter operates over that page, so deeply-buried files in
+     * very large libraries may not show up; admins should navigate by folder
+     * in that case.
+     */
+    listFiles: (accessToken: string, siteId: string, params?: {
+        readonly parentItemId?: string;
+        readonly query?: string;
+    }) => Promise<ExcelListFilesResult>;
+    resetData: (accessToken: string, ref: SpreadsheetFileRef, tabNames: readonly string[], headers: readonly string[], values: ReadonlyArray<readonly CellValue[]>, columns?: readonly ColumnMeta[], legendTab?: LegendTabData) => Promise<void>;
+    private readonly _requireDriveId;
+    private readonly _workbookUrl;
+    private readonly _authHeaders;
+    private readonly _parseJsonResponse;
+    private readonly _parseGraphError;
+    private readonly _createWorkbookSession;
+    private readonly _closeWorkbookSession;
+    private readonly _escapeWorksheetName;
+    private readonly _fetchWorksheetNames;
+    private readonly _fetchWorksheetUsedRangeValues;
+    private readonly _columnIndexToLetter;
+    private readonly _buildRangeAddress;
+    private readonly _writeRowsToWorksheet;
+    private readonly _clearWorksheet;
+    private readonly _renameFirstWorksheet;
+    private readonly _ensureWorksheetExists;
+    private readonly _writeLegendWorksheet;
+    private readonly _writeWorksheetWithDefaults;
+}
+export declare const excelSpreadsheetAdapter: ExcelSpreadsheetAdapter;

package/dist/webhook/excel-workbook-client.js

@@ -0,0 +1 @@
+import{z as e}from"zod";import{EMPTY_XLSX_BYTES as t}from"./empty-xlsx.js";import{SpreadsheetAdapterError as r,normalizeCellOnWrite as s}from"./spreadsheet-adapter.js";let a=e.object({id:e.string(),name:e.string(),webUrl:e.string().optional(),lastModifiedDateTime:e.string().optional(),folder:e.object({childCount:e.number().optional()}).optional(),file:e.object({mimeType:e.string().optional()}).optional(),parentReference:e.object({driveId:e.string().optional()}).optional()}),o=e.object({webUrl:e.string().optional()}),i=e.object({value:e.array(a)}),n=e.object({id:e.string()}),h=e.object({value:e.array(e.object({name:e.string()}))}),d=e.object({values:e.array(e.array(e.unknown())).optional()});export class ExcelSpreadsheetAdapter{_apiBaseUrl;constructor(e={}){this._apiBaseUrl=e.apiBaseUrl??"https://graph.microsoft.com/v1.0"}fetchMeta=async(e,t)=>({tabs:await this._fetchWorksheetNames(e,this._requireDriveId(t))});fetchWebUrl=async(e,t)=>{let r=this._requireDriveId(t),s=await fetch(`${this._apiBaseUrl}/drives/${encodeURIComponent(r.driveId)}/items/${encodeURIComponent(r.itemId)}?$select=webUrl`,{headers:{Authorization:`Bearer ${e}`}});return s.ok?(await this._parseJsonResponse(s,o,"fetch workbook webUrl")).webUrl??null:null};fetchTabHeaders=async(e,t,r)=>(await this._fetchWorksheetUsedRangeValues(e,this._requireDriveId(t),r))[0]??[];fetchData=async(e,t,r,s)=>{let a=s??0,o=this._requireDriveId(t),i=await this._createWorkbookSession(e,o);try{let t=[];for(let s of r){let r=await this._fetchWorksheetUsedRangeValues(e,o,s,i),n=r[a]??[],h=r.slice(a+1);t.push({headers:n,rows:h})}return t}finally{await this._closeWorkbookSession(e,o,i)}};createWorkbook=async(e,r,s,o,i,n,h,d)=>{if(!d?.siteId)throw Error("Excel workbook creation requires a SharePoint site context (location.siteId). The studio's CreateSheetButton must pass the configured site's id when called for the Microsoft provider.");let l=r.endsWith(".xlsx")?r:`${r}.xlsx`,c=`${this._apiBaseUrl}/sites/${encodeURIComponent(d.siteId)}/drive/root:/${encodeURIComponent(l)}:/content`,p=await fetch(c,{method:"PUT",headers:{Authorization:`Bearer ${e}`,"Content-Type":"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"},body:t});p.ok||await this._parseGraphError(p,`create workbook '${l}' in site`);let w=await this._parseJsonResponse(p,a,`create workbook '${l}'`);if(!w.parentReference?.driveId)throw Error("Created Excel workbook but Graph response did not include parentReference.driveId — this is unexpected. The workbook was created but cannot be addressed for follow-up writes.");let u={driveId:w.parentReference.driveId,itemId:w.id},k=n??"Sheet1",f=await this._createWorkbookSession(e,u);try{await this._renameFirstWorksheet(e,u,f,k),await this._writeWorksheetWithDefaults(e,u,f,k,s,o??[],i),h&&await this._writeLegendWorksheet(e,u,f,h)}finally{await this._closeWorkbookSession(e,u,f)}return{fileId:w.id,driveId:w.parentReference.driveId,title:w.name}};listFiles=async(e,t,r={})=>{let s=r.query?.trim().toLowerCase()??"",a=r.parentItemId?`/sites/${encodeURIComponent(t)}/drive/items/${encodeURIComponent(r.parentItemId)}/children`:`/sites/${encodeURIComponent(t)}/drive/root/children`,o=await fetch(`${this._apiBaseUrl}${a}`,{headers:{Authorization:`Bearer ${e}`}});o.ok||await this._parseGraphError(o,"list drive items");let n=await this._parseJsonResponse(o,i,"list drive items"),h=[],d=[];for(let e of n.value){if(""===s||e.name.toLowerCase().includes(s)){if(e.folder){""===s&&h.push({itemId:e.id,name:e.name});continue}e.file&&e.name.toLowerCase().endsWith(".xlsx")&&e.parentReference?.driveId&&d.push({itemId:e.id,driveId:e.parentReference.driveId,name:e.name,webUrl:e.webUrl??null,lastModified:e.lastModifiedDateTime??null})}}return{folders:h,files:d}};resetData=async(e,t,r,s,a,o,i)=>{let n=this._requireDriveId(t),h=await this._createWorkbookSession(e,n);try{for(let t of r)await this._ensureWorksheetExists(e,n,h,t),await this._clearWorksheet(e,n,h,t),await this._writeWorksheetWithDefaults(e,n,h,t,s,a,o);i&&await this._writeLegendWorksheet(e,n,h,i)}finally{await this._closeWorkbookSession(e,n,h)}};_requireDriveId=e=>{if(!e.driveId)throw Error("Excel workbook reference is missing driveId. Microsoft Graph requires both driveId and itemId. Make sure ConnectedDataConfig.driveId is set when provider is 'microsoft'.");return{driveId:e.driveId,itemId:e.fileId}};_workbookUrl=({driveId:e,itemId:t},r)=>`${this._apiBaseUrl}/drives/${encodeURIComponent(e)}/items/${encodeURIComponent(t)}/workbook${r}`;_authHeaders=(e,t)=>{let r={Authorization:`Bearer ${e}`,"Content-Type":"application/json"};return t&&(r["workbook-session-id"]=t),r};_parseJsonResponse=async(e,t,s)=>{let a=await e.json().catch(()=>null),o=t.safeParse(a);if(!o.success)throw new r({kind:"unknown",provider:"microsoft",status:e.status,action:s,bodyExcerpt:JSON.stringify(a).slice(0,500),message:`Microsoft Graph ${s} returned a response that does not match the expected shape — this likely means the Graph API contract has changed. Validation issues: ${o.error.issues.map(e=>`${e.path.join(".")}: ${e.message}`).join("; ")}`});return o.data};_parseGraphError=async(e,t)=>{let s=(await e.text().catch(()=>"")).slice(0,500),a=e.status,o=(e,o)=>{throw new r({kind:e,provider:"microsoft",status:a,action:t,bodyExcerpt:s,message:o})};return 401===a?o("auth",`Microsoft Graph ${t} failed with status 401. The Graph app token was rejected — it may have expired or been revoked. The server should refresh the app token; if this persists, re-check the customer's app client id/secret in the SharePoint wizard. Body: ${s}`):403===a?o("forbidden",`Microsoft Graph ${t} failed with status 403 (accessDenied). The app reached the SharePoint site but does not have the required role. Most common cause: the per-site Sites.Selected grant was issued with roles: ["read"] only — writes require ["read", "write"]. A tenant admin must re-run POST /sites/{hostname}:{path}:/permissions with both roles in the body, or PATCH the existing permission to add "write". See docs/how-to-setup-microsoft-oauth-app.md \xa75. Body: ${s}`):400===a&&s.includes("Resource not found for the segment")?o("unknown",`Microsoft Graph ${t} failed with status 400. The request path uses a Graph API segment that is not supported by the Excel workbook API. Check the Microsoft spreadsheet adapter for an unsupported endpoint before changing SharePoint grants. Body: ${s}`):404===a?o("not-found",`Microsoft Graph ${t} failed with status 404. The site, drive, or workbook item was not found, or the app has no access to it. If the workbook was moved or deleted, re-pick it via the in-house picker. Body: ${s}`):423===a?o("locked",`Microsoft Graph ${t} failed with status 423 (locked). The workbook is open in desktop Excel — close it and retry. Body: ${s}`):429===a?o("rate-limit",`Microsoft Graph ${t} failed with status 429 (throttled). Wait a moment and retry. Body: ${s}`):o("unknown",`Microsoft Graph ${t} failed with status ${a}. Verify the app token has Sites.Selected (Application) admin-consented, and that the configured site has a per-site grant with roles: ["read", "write"]. Body: ${s}`)};_createWorkbookSession=async(e,t)=>{let r=await fetch(this._workbookUrl(t,"/createSession"),{method:"POST",headers:this._authHeaders(e),body:JSON.stringify({persistChanges:!0})});return r.ok||await this._parseGraphError(r,"createSession"),(await this._parseJsonResponse(r,n,"createSession")).id};_closeWorkbookSession=async(e,t,r)=>{await fetch(this._workbookUrl(t,"/closeSession"),{method:"POST",headers:this._authHeaders(e,r)})};_escapeWorksheetName=e=>`'${e.replace(/'/g,"''")}'`;_fetchWorksheetNames=async(e,t,r)=>{let s=await fetch(this._workbookUrl(t,"/worksheets?$select=name"),{headers:this._authHeaders(e,r)});return s.ok||await this._parseGraphError(s,"list worksheets"),(await this._parseJsonResponse(s,h,"list worksheets")).value.map(e=>e.name)};_fetchWorksheetUsedRangeValues=async(e,t,r,s)=>{let a=`/worksheets(${this._escapeWorksheetName(r)})/usedRange?$select=values`,o=await fetch(this._workbookUrl(t,a),{headers:this._authHeaders(e,s)});if(!o.ok){if(404===o.status)return[];await this._parseGraphError(o,`read worksheet "${r}"`)}return((await this._parseJsonResponse(o,d,`read worksheet "${r}"`)).values??[]).map(e=>e.map(e=>null==e?"":String(e)))};_columnIndexToLetter=e=>{let t="",r=e;for(;r>=0;)t=String.fromCharCode(65+r%26)+t,r=Math.floor(r/26)-1;return t};_buildRangeAddress=(e,t,r)=>{let s=this._columnIndexToLetter(r-1);return`A${e}:${s}${t}`};_writeRowsToWorksheet=async(e,t,r,s,a)=>{if(0===a.length)return;let o=Math.max(...a.map(e=>e.length)),i=this._buildRangeAddress(1,a.length,o),n=`/worksheets(${this._escapeWorksheetName(s)})/range(address='${i}')`,h=a.map(e=>{let t=[...e];for(;t.length<o;)t.push("");return t}),d=await fetch(this._workbookUrl(t,n),{method:"PATCH",headers:this._authHeaders(e,r),body:JSON.stringify({values:h})});d.ok||await this._parseGraphError(d,`write range to "${s}"`)};_clearWorksheet=async(e,t,r,s)=>{let a=`/worksheets(${this._escapeWorksheetName(s)})/usedRange/clear`,o=await fetch(this._workbookUrl(t,a),{method:"POST",headers:this._authHeaders(e,r),body:JSON.stringify({applyTo:"All"})});o.ok||404===o.status||await this._parseGraphError(o,`clear worksheet "${s}"`)};_renameFirstWorksheet=async(e,t,r,s)=>{let a=(await this._fetchWorksheetNames(e,t,r))[0];if(!a||a===s)return;let o=`/worksheets(${this._escapeWorksheetName(a)})`,i=await fetch(this._workbookUrl(t,o),{method:"PATCH",headers:this._authHeaders(e,r),body:JSON.stringify({name:s})});i.ok||await this._parseGraphError(i,`rename worksheet '${a}' to '${s}'`)};_ensureWorksheetExists=async(e,t,r,s)=>{if((await this._fetchWorksheetNames(e,t,r)).includes(s))return;let a=await fetch(this._workbookUrl(t,"/worksheets/add"),{method:"POST",headers:this._authHeaders(e,r),body:JSON.stringify({name:s})});a.ok||await this._parseGraphError(a,`add worksheet "${s}"`)};_writeLegendWorksheet=async(e,t,r,s)=>{await this._ensureWorksheetExists(e,t,r,s.tabName),await this._clearWorksheet(e,t,r,s.tabName);let a=s.rows.map(e=>[...e]);await this._writeRowsToWorksheet(e,t,r,s.tabName,[["Field","Type","Description","Possible Values"],...a])};_writeWorksheetWithDefaults=async(e,t,r,a,o,i,n)=>{let h=[...o],d=i.map(e=>e.map((e,t)=>s(e,n?.[t])));await this._writeRowsToWorksheet(e,t,r,a,[h,...d])}}export const excelSpreadsheetAdapter=new ExcelSpreadsheetAdapter;

package/dist/webhook/google-sheets-client.d.ts

@@ -0,0 +1,23 @@
+import { type CellValue, type ColumnMeta, type CreateSpreadsheetResult, type LegendTabData, type SheetTabData, type SpreadsheetAdapter, type SpreadsheetFileRef, type SpreadsheetMeta } from './spreadsheet-adapter.js';
+export interface GoogleSpreadsheetAdapterOptions {
+    /** Override for staging/test environments. Defaults to the production Google Sheets API endpoint. */
+    readonly apiBaseUrl?: string;
+}
+export declare class GoogleSpreadsheetAdapter implements SpreadsheetAdapter {
+    private readonly _apiBaseUrl;
+    constructor(options?: GoogleSpreadsheetAdapterOptions);
+    private readonly _parseJsonResponse;
+    private readonly _parseSheetsError;
+    fetchMeta: (accessToken: string, ref: SpreadsheetFileRef) => Promise<SpreadsheetMeta>;
+    fetchTabHeaders: (accessToken: string, ref: SpreadsheetFileRef, tabName: string) => Promise<readonly string[]>;
+    fetchData: (accessToken: string, ref: SpreadsheetFileRef, tabNames: readonly string[], headerRowIndex?: number | null) => Promise<readonly SheetTabData[]>;
+    createWorkbook: (accessToken: string, title: string, headers: readonly string[], values?: ReadonlyArray<readonly CellValue[]>, columns?: readonly ColumnMeta[], dataTabName?: string, legendTab?: LegendTabData) => Promise<CreateSpreadsheetResult>;
+    resetData: (accessToken: string, ref: SpreadsheetFileRef, tabNames: readonly string[], headers: readonly string[], values: ReadonlyArray<readonly CellValue[]>, columns?: readonly ColumnMeta[], legendTab?: LegendTabData) => Promise<void>;
+    private readonly _toCellValue;
+    private readonly _toDataCellFormat;
+    private readonly _buildHeaderValidationRequests;
+    private readonly _buildDataValidationRequests;
+    private readonly _fetchSheetIdMap;
+    private readonly _writeLegendTab;
+}
+export declare const googleSpreadsheetAdapter: GoogleSpreadsheetAdapter;

package/dist/webhook/google-sheets-client.js

@@ -0,0 +1 @@
+import{z as e}from"zod";import{SpreadsheetAdapterError as t,normalizeCellOnWrite as a}from"./spreadsheet-adapter.js";let s=e.object({sheets:e.array(e.object({properties:e.object({title:e.string()})}))}),r=e.object({sheets:e.array(e.object({properties:e.object({title:e.string(),sheetId:e.number()})}))}),o=e.object({spreadsheetId:e.string(),properties:e.object({title:e.string()}),sheets:e.array(e.object({properties:e.object({sheetId:e.number()})})).min(1)}),i=e.object({values:e.array(e.array(e.unknown())).optional()});export class GoogleSpreadsheetAdapter{_apiBaseUrl;constructor(e={}){this._apiBaseUrl=e.apiBaseUrl??"https://sheets.googleapis.com/v4/spreadsheets"}_parseJsonResponse=async(e,a,s)=>{let r=await e.json().catch(()=>null),o=a.safeParse(r);if(!o.success)throw new t({kind:"unknown",provider:"google",status:e.status,action:s,bodyExcerpt:JSON.stringify(r).slice(0,500),message:`Google Sheets ${s} returned a response that does not match the expected shape — this likely means the Sheets API contract has changed. Validation issues: ${o.error.issues.map(e=>`${e.path.join(".")}: ${e.message}`).join("; ")}`});return o.data};_parseSheetsError=async(e,a)=>{let s=(await e.text().catch(()=>"")).slice(0,500),r=e.status,o=(e,o)=>{throw new t({kind:e,provider:"google",status:r,action:a,bodyExcerpt:s,message:o})};return 401===r?o("auth",`Google Sheets ${a} failed with status 401. The OAuth access token was rejected — most likely the connected Google account's token has been revoked or expired. Reconnect Google in the SuperAdmin panel and retry. Body: ${s}`):403===r?o("forbidden",`Google Sheets ${a} failed with status 403. The token is valid but the API rejected the request. Common causes: (1) the file was not picked via Google Picker — the configurator uses the 'drive.file' scope, which only grants access to files the user explicitly selected through Picker; (2) the Google Sheets API is not enabled on the OAuth app's GCP project; (3) the daily quota has been exceeded. Body: ${s}`):404===r?o("not-found",`Google Sheets ${a} failed with status 404. The spreadsheet was not found or the OAuth token has no access to it. Re-pick the file via the Google Picker. Body: ${s}`):429===r?o("rate-limit",`Google Sheets ${a} failed with status 429 (rate-limited). Wait a moment and retry. Body: ${s}`):o("unknown",`Google Sheets ${a} failed with status ${r}. Verify the OAuth connection is still active and that the Sheets API is reachable. Body: ${s}`)};fetchMeta=async(e,t)=>{let a=await fetch(`${this._apiBaseUrl}/${t.fileId}?fields=sheets.properties`,{headers:{Authorization:`Bearer ${e}`}});return a.ok||await this._parseSheetsError(a,"fetch spreadsheet metadata"),{tabs:(await this._parseJsonResponse(a,s,"fetch spreadsheet metadata")).sheets.map(e=>e.properties.title)}};fetchTabHeaders=async(e,t,a)=>{let s=encodeURIComponent(`'${a}'!1:1`),r=await fetch(`${this._apiBaseUrl}/${t.fileId}/values/${s}`,{headers:{Authorization:`Bearer ${e}`}});r.ok||await this._parseSheetsError(r,`fetch tab headers for "${a}"`);let o=await this._parseJsonResponse(r,i,`fetch tab headers for "${a}"`);return(o.values?.[0]??[]).map(e=>null==e?"":String(e))};fetchData=async(e,t,a,s)=>{let r=s??0,o=[];for(let s of a){let a=encodeURIComponent(`'${s}'`),n=await fetch(`${this._apiBaseUrl}/${t.fileId}/values/${a}`,{headers:{Authorization:`Bearer ${e}`}});n.ok||await this._parseSheetsError(n,`fetch sheet data for tab "${s}"`);let l=((await this._parseJsonResponse(n,i,`fetch sheet data for tab "${s}"`)).values??[]).map(e=>e.map(e=>null==e?"":String(e))),h=l[r]??[],d=l.slice(r+1);o.push({headers:h,rows:d})}return o};createWorkbook=async(e,t,s,r,i,n,l)=>{let h=[{properties:{title:n??"Sheet1"},data:[{startRow:0,startColumn:0,rowData:[{values:s.map(e=>({userEnteredValue:{stringValue:e},userEnteredFormat:{textFormat:{bold:!0},numberFormat:{type:"TEXT"}}}))},...(r??[]).map(e=>({values:e.map((e,t)=>{let s=this._toCellValue(a(e,i?.[t])),r=this._toDataCellFormat(i?.[t]);return r?{...s,userEnteredFormat:r}:s})}))]}]}];if(l){let e={values:["Field","Type","Description","Possible Values"].map(e=>({userEnteredValue:{stringValue:e},userEnteredFormat:{textFormat:{bold:!0}}}))},t=l.rows.map(e=>({values:e.map(e=>({userEnteredValue:{stringValue:e}}))}));h.push({properties:{title:l.tabName},data:[{startRow:0,startColumn:0,rowData:[e,...t]}]})}let d=await fetch(this._apiBaseUrl,{method:"POST",headers:{Authorization:`Bearer ${e}`,"Content-Type":"application/json"},body:JSON.stringify({properties:{title:t},sheets:h})});d.ok||await this._parseSheetsError(d,`create spreadsheet '${t}'`);let p=await this._parseJsonResponse(d,o,`create spreadsheet '${t}'`),u=p.sheets[0].properties.sheetId,c=[...this._buildHeaderValidationRequests(u,s),...this._buildDataValidationRequests(u,i)];return c.length>0&&await fetch(`${this._apiBaseUrl}/${p.spreadsheetId}:batchUpdate`,{method:"POST",headers:{Authorization:`Bearer ${e}`,"Content-Type":"application/json"},body:JSON.stringify({requests:c})}),{fileId:p.spreadsheetId,driveId:null,title:p.properties.title}};resetData=async(e,t,s,r,o,i,n)=>{let l=t.fileId,h=await this._fetchSheetIdMap(e,l);for(let t of s){let s=h.get(t);if(void 0===s)continue;let n=encodeURIComponent(`'${t}'`);await fetch(`${this._apiBaseUrl}/${l}/values/${n}:clear`,{method:"POST",headers:{Authorization:`Bearer ${e}`}});let d=[{updateCells:{rows:[{values:r.map(e=>({userEnteredValue:{stringValue:e},userEnteredFormat:{textFormat:{bold:!0},numberFormat:{type:"TEXT"}}}))},...o.map(e=>e.map((e,t)=>{let s=this._toCellValue(a(e,i?.[t])),r=this._toDataCellFormat(i?.[t]);return r?{...s,userEnteredFormat:r}:s})).map(e=>({values:e}))],fields:"userEnteredValue,userEnteredFormat",start:{sheetId:s,rowIndex:0,columnIndex:0}}},...this._buildHeaderValidationRequests(s,r),...this._buildDataValidationRequests(s,i)],p=await fetch(`${this._apiBaseUrl}/${l}:batchUpdate`,{method:"POST",headers:{Authorization:`Bearer ${e}`,"Content-Type":"application/json"},body:JSON.stringify({requests:d})});p.ok||await this._parseSheetsError(p,`reset sheet data for tab "${t}"`)}n&&await this._writeLegendTab(e,l,n,h)};_toCellValue=e=>"boolean"==typeof e?{userEnteredValue:{boolValue:e}}:"number"==typeof e?{userEnteredValue:{numberValue:e}}:{userEnteredValue:{stringValue:e}};_toDataCellFormat=e=>{if(e&&("number"===e.type||"integer"===e.type))return{numberFormat:{type:"NUMBER"}}};_buildHeaderValidationRequests=(e,t)=>t.map((t,a)=>({setDataValidation:{range:{sheetId:e,startRowIndex:0,endRowIndex:1,startColumnIndex:a,endColumnIndex:a+1},rule:{condition:{type:"ONE_OF_LIST",values:[{userEnteredValue:t}]},strict:!0,showCustomUi:!1}}}));_buildDataValidationRequests=(e,t)=>t?t.flatMap((t,a)=>"boolean"===t.type?[{setDataValidation:{range:{sheetId:e,startRowIndex:1,startColumnIndex:a,endColumnIndex:a+1},rule:{condition:{type:"BOOLEAN"},showCustomUi:!0}}}]:t.enum&&0!==t.enum.length?[{setDataValidation:{range:{sheetId:e,startRowIndex:1,startColumnIndex:a,endColumnIndex:a+1},rule:{condition:{type:"ONE_OF_LIST",values:t.enum.map(e=>({userEnteredValue:String(e)}))},strict:!0,showCustomUi:!0}}}]:[]):[];_fetchSheetIdMap=async(e,t)=>{let a=await fetch(`${this._apiBaseUrl}/${t}?fields=sheets.properties`,{headers:{Authorization:`Bearer ${e}`}});return a.ok||await this._parseSheetsError(a,"fetch sheet id map"),new Map((await this._parseJsonResponse(a,r,"fetch sheet id map")).sheets.map(e=>[e.properties.title,e.properties.sheetId]))};_writeLegendTab=async(e,t,a,s)=>{if(void 0!==s.get(a.tabName)){let s=encodeURIComponent(`'${a.tabName}'`);await fetch(`${this._apiBaseUrl}/${t}/values/${s}:clear`,{method:"POST",headers:{Authorization:`Bearer ${e}`}})}else{let s=await fetch(`${this._apiBaseUrl}/${t}:batchUpdate`,{method:"POST",headers:{Authorization:`Bearer ${e}`,"Content-Type":"application/json"},body:JSON.stringify({requests:[{addSheet:{properties:{title:a.tabName}}}]})});s.ok||await this._parseSheetsError(s,"add legend tab")}let r=["Field","Type","Description","Possible Values"].map(e=>({userEnteredValue:{stringValue:e},userEnteredFormat:{textFormat:{bold:!0}}})),o=a.rows.map(e=>e.map(e=>({userEnteredValue:{stringValue:e}}))),i=(await this._fetchSheetIdMap(e,t)).get(a.tabName);if(void 0===i)return;let n=await fetch(`${this._apiBaseUrl}/${t}:batchUpdate`,{method:"POST",headers:{Authorization:`Bearer ${e}`,"Content-Type":"application/json"},body:JSON.stringify({requests:[{updateCells:{rows:[{values:r},...o.map(e=>({values:e}))],fields:"userEnteredValue,userEnteredFormat",start:{sheetId:i,rowIndex:0,columnIndex:0}}}]})});n.ok||await this._parseSheetsError(n,"update legend tab")}}export const googleSpreadsheetAdapter=new GoogleSpreadsheetAdapter;

package/dist/webhook/implementation/index.d.ts

@@ -0,0 +1,4 @@
+export { routeWebhookRequests } from './webhook-routing.js';
+export { TunneledWebhookRequest, TunneledWebhookResponse, WebhookTunnelPollRequest, WebhookTunnelPollResponse, WebhookTunnelRespondRequest, } from './webhook-tunnel-types.js';
+export { WebhookClient, createUrlWebhookHttpClient, fetchWebhookHttpClient, type WebhookHttpClient, } from './webhook-client.js';
+export { AuthHandlerResponse, AuthUserIdSource, RefreshPayload, CodePayload, AuthPayload, AnonymousPayload, FinalizeWebhookPayload, CallbackPayload, CallbackResponse, FetchBackendDataPayload, FetchBackendDataHandlerResponse, } from './webhook-api-types.js';

package/dist/webhook/implementation/index.js

@@ -0,0 +1 @@
+export{routeWebhookRequests}from"./webhook-routing.js";export{TunneledWebhookRequest,TunneledWebhookResponse,WebhookTunnelPollRequest,WebhookTunnelPollResponse,WebhookTunnelRespondRequest}from"./webhook-tunnel-types.js";export{WebhookClient,createUrlWebhookHttpClient,fetchWebhookHttpClient}from"./webhook-client.js";export{AuthHandlerResponse,AuthUserIdSource,RefreshPayload,CodePayload,AuthPayload,AnonymousPayload,FinalizeWebhookPayload,CallbackPayload,CallbackResponse,FetchBackendDataPayload,FetchBackendDataHandlerResponse}from"./webhook-api-types.js";

package/dist/webhook/implementation/webhook-api-types.d.ts

@@ -0,0 +1,302 @@
+import { z } from 'zod';
+import { SessionRole } from '../../api/index.js';
+import type { Entity } from '../../domain/index.js';
+import { ConfigurationId, DeploymentId, FrontendUrl, RevisionId } from '../../domain/index.js';
+import { CallLambdaBackResourceType } from '../tasks/index.js';
+export interface CallbackPayload<REPLAY_DATA extends Record<string, unknown>, RESOURCE extends string> {
+    replayData: REPLAY_DATA;
+    resources: Partial<Record<RESOURCE, {
+        type: CallLambdaBackResourceType;
+        link: string;
+    }>> & Record<string, {
+        type: CallLambdaBackResourceType;
+        link: string;
+    }>;
+}
+export declare const CallbackPayload: z.ZodType<CallbackPayload<Record<string, unknown>, string>>;
+export interface CallbackResponse<RESULT extends Record<string, unknown>> {
+    result?: RESULT;
+}
+export declare const CallbackResponse: z.ZodType<CallbackResponse<Record<string, unknown>>>;
+/** The identity provider of a user id an auth handler returns; it becomes the prefix of the session `sub`. */
+export declare const AuthUserIdSource: z.ZodEnum<["clerk", "custom"]>;
+export type AuthUserIdSource = z.infer<typeof AuthUserIdSource>;
+export declare const AuthHandlerResponse: z.ZodDiscriminatedUnion<"success", [z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    role: z.ZodNativeEnum<{
+        readonly Anonymous: 'anonymous';
+        readonly User: 'user';
+        readonly Admin: 'admin';
+        readonly SuperAdmin: 'superadmin';
+    }>;
+    refreshToken: z.ZodOptional<z.ZodString>;
+    expirationTime: z.ZodOptional<z.ZodNumber>;
+    scopes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    userId: z.ZodOptional<z.ZodString>;
+    userIdSource: z.ZodOptional<z.ZodEnum<["clerk", "custom"]>>;
+}, "strip", z.ZodTypeAny, {
+    success: true;
+    data: Record<string, unknown>;
+    role: "admin" | "anonymous" | "superadmin" | "user";
+    refreshToken?: string | undefined;
+    expirationTime?: number | undefined;
+    scopes?: string[] | undefined;
+    userId?: string | undefined;
+    userIdSource?: "clerk" | "custom" | undefined;
+}, {
+    success: true;
+    data: Record<string, unknown>;
+    role: "admin" | "anonymous" | "superadmin" | "user";
+    refreshToken?: string | undefined;
+    expirationTime?: number | undefined;
+    scopes?: string[] | undefined;
+    userId?: string | undefined;
+    userIdSource?: "clerk" | "custom" | undefined;
+}>, z.ZodObject<{
+    success: z.ZodLiteral<false>;
+}, "strip", z.ZodTypeAny, {
+    success: false;
+}, {
+    success: false;
+}>]>;
+export interface AuthHandlerSuccessResponse<SESSION_DATA extends Record<string, unknown>> {
+    success: true;
+    data: SESSION_DATA;
+    role: SessionRole;
+    refreshToken?: string;
+    /**
+     * Defaults to 3h, it should not be overridden if not 100% needed. It is used to calculate session tracking and changing this time
+     * will make sessions longer.
+     */
+    expirationTime?: number;
+    scopes?: readonly string[];
+    /**
+     * The id of the signed-in user, unprefixed. The server namespaces it with {@link userIdSource} into the
+     * session token's `sub`. When omitted, the session falls back to the browser's anonymous id.
+     */
+    userId?: string;
+    /**
+     * Which identity provider {@link userId} comes from. Defaults to `custom`. The SDK's auth handler builder
+     * sets it: `clerk` for its Clerk handlers, `custom` for every other handler.
+     */
+    userIdSource?: AuthUserIdSource;
+}
+export interface AuthHandlerErrorResponse {
+    success: false;
+}
+export type AuthHandlerResponse<SESSION_DATA extends Record<string, unknown>> = AuthHandlerSuccessResponse<SESSION_DATA> | AuthHandlerErrorResponse;
+export declare const RefreshPayload: z.ZodObject<{
+    type: z.ZodLiteral<"refresh">;
+    refreshToken: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "refresh";
+    refreshToken: string;
+}, {
+    type: "refresh";
+    refreshToken: string;
+}>;
+export type RefreshPayload = z.infer<typeof RefreshPayload>;
+export declare const CodePayload: z.ZodObject<{
+    type: z.ZodLiteral<"code">;
+    accessToken: z.ZodString;
+    refreshToken: z.ZodOptional<z.ZodString>;
+    idToken: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "code";
+    accessToken: string;
+    refreshToken?: string | undefined;
+    idToken?: string | undefined;
+}, {
+    type: "code";
+    accessToken: string;
+    refreshToken?: string | undefined;
+    idToken?: string | undefined;
+}>;
+export type CodePayload = z.infer<typeof CodePayload>;
+export declare const AnonymousPayload: z.ZodObject<{
+    type: z.ZodLiteral<"anonymous">;
+}, "strip", z.ZodTypeAny, {
+    type: "anonymous";
+}, {
+    type: "anonymous";
+}>;
+export type AnonymousPayload = z.infer<typeof AnonymousPayload>;
+export declare const AuthPayload: z.ZodUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"refresh">;
+    refreshToken: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "refresh";
+    refreshToken: string;
+}, {
+    type: "refresh";
+    refreshToken: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"code">;
+    accessToken: z.ZodString;
+    refreshToken: z.ZodOptional<z.ZodString>;
+    idToken: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "code";
+    accessToken: string;
+    refreshToken?: string | undefined;
+    idToken?: string | undefined;
+}, {
+    type: "code";
+    accessToken: string;
+    refreshToken?: string | undefined;
+    idToken?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"anonymous">;
+}, "strip", z.ZodTypeAny, {
+    type: "anonymous";
+}, {
+    type: "anonymous";
+}>]>;
+export type AuthPayload = z.infer<typeof AuthPayload>;
+export interface FinalizeWebhookPayload<FINALIZE_DATA extends Record<string, unknown>, ENTITIES extends {
+    id: string;
+    type: string;
+}, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>> {
+    configurationId: ConfigurationId;
+    revisionId: RevisionId;
+    deploymentId: DeploymentId;
+    frontendUrl: FrontendUrl;
+    rootEntityType: Entity['type'];
+    entities: ENTITIES[];
+    modelVersion: number;
+    data: FINALIZE_DATA;
+    frontendData?: FRONTEND_DATA;
+    locale: string;
+    sessionRole: SessionRole;
+    sessionPayload: SESSION_DATA;
+    publishedAdminRevisionPath?: string;
+    publishedChunkUrls?: Record<string, string>;
+    /**
+     * Pre-signed PUT URL for staging connected-data chunks outside the webhook response. Optional on purpose: older
+     * servers never send it and older SDKs ignore it, so the SDK feature-detects staging by its presence.
+     */
+    chunksUploadUrl?: string;
+    connectedProviderAccessTokens?: Record<string, string>;
+}
+export declare const FinalizeWebhookPayload: z.ZodObject<{
+    configurationId: z.ZodEffects<z.ZodString, ConfigurationId, string>;
+    revisionId: z.ZodEffects<z.ZodString, RevisionId, string>;
+    deploymentId: z.ZodEffects<z.ZodString, DeploymentId, string>;
+    frontendUrl: z.ZodEffects<z.ZodString, FrontendUrl, string>;
+    rootEntityType: z.ZodString;
+    entities: z.ZodArray<z.ZodIntersection<z.ZodObject<{
+        type: z.ZodString;
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        id: string;
+    }, {
+        type: string;
+        id: string;
+    }>, z.ZodRecord<z.ZodString, z.ZodUnknown>>, "many">;
+    modelVersion: z.ZodNumber;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    frontendData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    locale: z.ZodString;
+    sessionRole: z.ZodNativeEnum<{
+        readonly Anonymous: 'anonymous';
+        readonly User: 'user';
+        readonly Admin: 'admin';
+        readonly SuperAdmin: 'superadmin';
+    }>;
+    sessionPayload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    publishedAdminRevisionPath: z.ZodOptional<z.ZodString>;
+    publishedChunkUrls: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    chunksUploadUrl: z.ZodOptional<z.ZodString>;
+    connectedProviderAccessTokens: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    configurationId: string & import("@salsita-ai/common/utils").Brand<"ConfigurationId">;
+    revisionId: string & import("@salsita-ai/common/utils").Brand<"RevisionId">;
+    deploymentId: string & import("@salsita-ai/common/utils").Brand<"DeploymentId">;
+    frontendUrl: string & import("@salsita-ai/common/utils").Brand<"FrontendUrl">;
+    rootEntityType: string;
+    entities: ({
+        type: string;
+        id: string;
+    } & Record<string, unknown>)[];
+    modelVersion: number;
+    data: Record<string, unknown>;
+    frontendData?: Record<string, unknown> | undefined;
+    locale: string;
+    sessionRole: "admin" | "anonymous" | "superadmin" | "user";
+    sessionPayload: Record<string, unknown>;
+    publishedAdminRevisionPath?: string | undefined;
+    publishedChunkUrls?: Record<string, string> | undefined;
+    chunksUploadUrl?: string | undefined;
+    connectedProviderAccessTokens?: Record<string, string> | undefined;
+}, {
+    configurationId: string;
+    revisionId: string;
+    deploymentId: string;
+    frontendUrl: string;
+    rootEntityType: string;
+    entities: ({
+        type: string;
+        id: string;
+    } & Record<string, unknown>)[];
+    modelVersion: number;
+    data: Record<string, unknown>;
+    frontendData?: Record<string, unknown> | undefined;
+    locale: string;
+    sessionRole: "admin" | "anonymous" | "superadmin" | "user";
+    sessionPayload: Record<string, unknown>;
+    publishedAdminRevisionPath?: string | undefined;
+    publishedChunkUrls?: Record<string, string> | undefined;
+    chunksUploadUrl?: string | undefined;
+    connectedProviderAccessTokens?: Record<string, string> | undefined;
+}>;
+export interface FetchBackendDataPayload<SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>> {
+    deploymentId: DeploymentId;
+    frontendUrl: FrontendUrl;
+    frontendData?: FRONTEND_DATA;
+    sessionRole: SessionRole;
+    sessionPayload: SESSION_DATA;
+    publishedAdminRevisionPath?: string;
+    publishedChunkUrls?: Record<string, string>;
+}
+export declare const FetchBackendDataPayload: z.ZodObject<{
+    deploymentId: z.ZodEffects<z.ZodString, DeploymentId, string>;
+    frontendUrl: z.ZodEffects<z.ZodString, FrontendUrl, string>;
+    frontendData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    sessionRole: z.ZodNativeEnum<{
+        readonly Anonymous: 'anonymous';
+        readonly User: 'user';
+        readonly Admin: 'admin';
+        readonly SuperAdmin: 'superadmin';
+    }>;
+    sessionPayload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    publishedAdminRevisionPath: z.ZodOptional<z.ZodString>;
+    publishedChunkUrls: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    deploymentId: string & import("@salsita-ai/common/utils").Brand<"DeploymentId">;
+    frontendUrl: string & import("@salsita-ai/common/utils").Brand<"FrontendUrl">;
+    frontendData?: Record<string, unknown> | undefined;
+    sessionRole: "admin" | "anonymous" | "superadmin" | "user";
+    sessionPayload: Record<string, unknown>;
+    publishedAdminRevisionPath?: string | undefined;
+    publishedChunkUrls?: Record<string, string> | undefined;
+}, {
+    deploymentId: string;
+    frontendUrl: string;
+    frontendData?: Record<string, unknown> | undefined;
+    sessionRole: "admin" | "anonymous" | "superadmin" | "user";
+    sessionPayload: Record<string, unknown>;
+    publishedAdminRevisionPath?: string | undefined;
+    publishedChunkUrls?: Record<string, string> | undefined;
+}>;
+export interface FetchBackendDataHandlerResponse {
+    backendData: Record<string, unknown>;
+}
+export declare const FetchBackendDataHandlerResponse: z.ZodObject<{
+    backendData: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    backendData: Record<string, unknown>;
+}, {
+    backendData: Record<string, unknown>;
+}>;

package/dist/webhook/implementation/webhook-api-types.js

@@ -0,0 +1 @@
+import{z as o}from"zod";import{usingType as n}from"@salsita-ai/common/utils";import{SessionRole as e}from"../../api/index.js";import{ConfigurationId as r,DeploymentId as t,FrontendUrl as s,RevisionId as a}from"../../domain/index.js";import{CallLambdaBackResourceType as i}from"../tasks/index.js";export const CallbackPayload=o.object({replayData:o.record(o.unknown()),resources:o.record(o.object({type:o.literal(i.Link),link:o.string()}))});export const CallbackResponse=o.object({result:o.record(o.unknown()).optional()});export const AuthUserIdSource=o.enum(["clerk","custom"]);export const AuthHandlerResponse=o.discriminatedUnion("success",[o.object({success:o.literal(!0),data:o.record(o.unknown()),role:o.nativeEnum(e),refreshToken:o.string().optional(),expirationTime:o.number().optional(),scopes:o.array(o.string()).optional(),userId:o.string().optional(),userIdSource:AuthUserIdSource.optional()}),o.object({success:o.literal(!1)})]);export const RefreshPayload=o.object({type:o.literal("refresh"),refreshToken:o.string()});export const CodePayload=o.object({type:o.literal("code"),accessToken:o.string(),refreshToken:o.string().optional(),idToken:o.string().optional()});export const AnonymousPayload=o.object({type:o.literal("anonymous")});export const AuthPayload=o.union([RefreshPayload,CodePayload,AnonymousPayload]);export const FinalizeWebhookPayload=o.object({configurationId:o.string().transform(n(r)),revisionId:o.string().transform(n(a)),deploymentId:o.string().transform(n(t)),frontendUrl:o.string().transform(n(s)),rootEntityType:o.string(),entities:o.array(o.object({type:o.string(),id:o.string()}).and(o.record(o.unknown()))),modelVersion:o.number().positive(),data:o.record(o.unknown()),frontendData:o.record(o.unknown()).optional(),locale:o.string(),sessionRole:o.nativeEnum(e),sessionPayload:o.record(o.unknown()),publishedAdminRevisionPath:o.string().optional(),publishedChunkUrls:o.record(o.string()).optional(),chunksUploadUrl:o.string().optional(),connectedProviderAccessTokens:o.record(o.string()).optional()});export const FetchBackendDataPayload=o.object({deploymentId:o.string().transform(n(t)),frontendUrl:o.string().transform(n(s)),frontendData:o.record(o.unknown()).optional(),sessionRole:o.nativeEnum(e),sessionPayload:o.record(o.unknown()),publishedAdminRevisionPath:o.string().optional(),publishedChunkUrls:o.record(o.string()).optional()});export const FetchBackendDataHandlerResponse=o.object({backendData:o.record(o.unknown())});

package/dist/webhook/implementation/webhook-client.d.ts

@@ -0,0 +1,85 @@
+import type { ApplicationType } from '../../domain/index.js';
+import { type CallbackPayload, CallbackResponse, type FetchBackendDataPayload, type FinalizeWebhookPayload } from './webhook-api-types.js';
+export type WebhookHttpClient = (url: string, init: RequestInit) => Promise<Response>;
+export declare const fetchWebhookHttpClient: WebhookHttpClient;
+export declare const createUrlWebhookHttpClient: (baseUrl: string, httpClient?: WebhookHttpClient) => WebhookHttpClient;
+export declare class WebhookClient {
+    private readonly _httpClient;
+    constructor(httpClient: WebhookHttpClient);
+    /** @deprecated Pass createUrlWebhookHttpClient(baseUrl, httpClient) instead. This overload will be removed in a future version. */
+    constructor(baseUrl: string, httpClient?: WebhookHttpClient);
+    handleRefreshFlow: (refreshToken: string) => Promise<{
+        success: true;
+        data: Record<string, unknown>;
+        role: "admin" | "anonymous" | "superadmin" | "user";
+        refreshToken?: string | undefined;
+        expirationTime?: number | undefined;
+        scopes?: string[] | undefined;
+        userId?: string | undefined;
+        userIdSource?: "clerk" | "custom" | undefined;
+    } | {
+        success: false;
+    }>;
+    handleCodeFlow: (accessToken: string, refreshToken: string | undefined, idToken: string | undefined) => Promise<{
+        success: true;
+        data: Record<string, unknown>;
+        role: "admin" | "anonymous" | "superadmin" | "user";
+        refreshToken?: string | undefined;
+        expirationTime?: number | undefined;
+        scopes?: string[] | undefined;
+        userId?: string | undefined;
+        userIdSource?: "clerk" | "custom" | undefined;
+    } | {
+        success: false;
+    }>;
+    handleAnonymousFlow: () => Promise<{
+        success: true;
+        data: Record<string, unknown>;
+        role: "admin" | "anonymous" | "superadmin" | "user";
+        refreshToken?: string | undefined;
+        expirationTime?: number | undefined;
+        scopes?: string[] | undefined;
+        userId?: string | undefined;
+        userIdSource?: "clerk" | "custom" | undefined;
+    } | {
+        success: false;
+    }>;
+    finalize: (data: FinalizeWebhookPayload<Record<string, unknown>, {
+        id: string;
+        type: string;
+    }, Record<string, unknown>, Record<string, unknown>>, applicationType: ApplicationType) => Promise<{
+        dataVersion: 1;
+        tasks: (import("../tasks/call-lambda-back-task.js").CallLambdaBackTask<Record<string, unknown>, string> | import("../tasks/edit-google-spreadsheet-task.js").EditGoogleSpreadsheetTask | import("../tasks/generate-csv-task.js").GenerateCsvTask | import("../tasks/generate-images-task.js").GenerateImagesTask | import("../tasks/generate-pdf-task.js").GeneratePdfTask | import("../tasks/generate-pdf-task.js").GenerateStaticPdfTask | import("../tasks/send-email-task.js").SendEmailTask | import("../tasks/send-http-task.js").SendHttpRequestTask | import("../tasks/send-email-task.js").SendStaticEmailTask | import("../tasks/woocommerce-add-to-cart-task.js").WooCommerceAddToCartTask | {
+            type: "GenerateConfigurationLink";
+            name: string;
+            frontendUrl: string & import("@salsita-ai/common/utils").Brand<"FrontendUrl">;
+            expiration?: number | undefined;
+            access: "o" | "r" | "rr";
+            configurationId: string & import("@salsita-ai/common/utils").Brand<"ConfigurationId">;
+            revisionId?: import("../../domain/index.js").RevisionId | undefined;
+        } | {
+            type: "PublishRevision";
+            version: number & import("@salsita-ai/common/utils").Brand<"PublishedDataRevisionVersion">;
+            revisionId: string & import("@salsita-ai/common/utils").Brand<"RevisionId">;
+            data: Record<string, unknown>;
+        } | {
+            type: "PublishRevisionChunks";
+            revisionId: string & import("@salsita-ai/common/utils").Brand<"RevisionId">;
+            chunks: {
+                key: string & import("@salsita-ai/common/utils").Brand<"ChunkKey">;
+                scope: string & import("@salsita-ai/common/utils").Brand<"ChunkScope">;
+                data: Record<string, unknown>;
+            }[];
+            publishedDataHash: string;
+        } | {
+            type: "PublishRevisionChunksStaged";
+            revisionId: string & import("@salsita-ai/common/utils").Brand<"RevisionId">;
+            publishedDataHash: string;
+        })[];
+        resources: import("../index.js").FinalizeTaskResource<string>[];
+    }>;
+    callback: (payload: CallbackPayload<Record<string, unknown>, string>) => Promise<CallbackResponse<Record<string, unknown>>>;
+    fetchBackendData: (payload: FetchBackendDataPayload<Record<string, unknown>, Record<string, unknown>>) => Promise<{
+        backendData: Record<string, unknown>;
+    }>;
+}

package/dist/webhook/implementation/webhook-client.js

@@ -0,0 +1 @@
+import{WebhookFinalizeTaskConfiguration as t}from"../tasks/index.js";import{AuthHandlerResponse as e,CallbackResponse as o,FetchBackendDataHandlerResponse as a}from"./webhook-api-types.js";import{getAuthRoute as i,getCallbackRoute as n,getFetchBackendDataRoute as r,getFinalizeRoute as s}from"./webhook-routing.js";export const fetchWebhookHttpClient=(t,e)=>fetch(t,e);export const createUrlWebhookHttpClient=(t,e=fetchWebhookHttpClient)=>(o,a)=>e(`${t}${o}`,a);export class WebhookClient{_httpClient;constructor(t,e=fetchWebhookHttpClient){this._httpClient="string"==typeof t?createUrlWebhookHttpClient(t,e):t}handleRefreshFlow=async t=>{let o=await this._httpClient(i(),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({type:"refresh",refreshToken:t})});if(!o.ok)throw Error(`Refresh webhook call failed: ${await o.text()}`);return e.parse(await o.json())};handleCodeFlow=async(t,o,a)=>{let n=await this._httpClient(i(),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({type:"code",accessToken:t,refreshToken:o,idToken:a})});if(!n.ok)throw Error(`Refresh webhook call failed: ${await n.text()}`);return e.parse(await n.json())};handleAnonymousFlow=async()=>{let t=await this._httpClient(i(),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({type:"anonymous"})});if(!t.ok)throw Error(`Refresh webhook call failed: ${await t.text()}`);return e.parse(await t.json())};finalize=async(e,o)=>{let a=await this._httpClient(s(o),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(e)});if(!a.ok)throw Error("Lambda call failed: "+await a.text());let i=await a.json();return t.parse(i)};callback=async t=>{let e=await this._httpClient(n(),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t)});if(!e.ok)throw Error("Lambda call failed: "+await e.text());let a=await e.json();return o.parse(a)};fetchBackendData=async t=>{let e=await this._httpClient(r(),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t)});if(!e.ok)throw Error("Lambda call failed: "+await e.text());return a.parse(await e.json())}}

package/dist/webhook/implementation/webhook-routing.d.ts

@@ -0,0 +1,30 @@
+import type { APIGatewayProxyEventV2, LambdaFunctionURLResult } from 'aws-lambda';
+import type { Logger } from '@salsita-ai/common/utils';
+import { ApplicationType } from '../../domain/index.js';
+import { type WebhookFinalizeTaskConfiguration } from '../tasks/index.js';
+import type { AuthHandlerResponse, CallbackResponse, FetchBackendDataHandlerResponse } from './webhook-api-types.js';
+import { AuthPayload, CallbackPayload, FetchBackendDataPayload, FinalizeWebhookPayload } from './webhook-api-types.js';
+export declare const getAuthRoute: () => string;
+export declare const getFinalizeRoute: (applicationType: ApplicationType) => string;
+export declare const getCallbackRoute: () => string;
+export declare const getFetchBackendDataRoute: () => string;
+export declare const handleWebhookSafely: (handler: (e: APIGatewayProxyEventV2) => Promise<LambdaFunctionURLResult>, logger: Logger) => (event: APIGatewayProxyEventV2) => Promise<LambdaFunctionURLResult>;
+type CallbackHandler = (body: CallbackPayload<Record<string, unknown>, string>, e: APIGatewayProxyEventV2) => Promise<CallbackResponse<Record<string, unknown>>>;
+type FinalizeHandler = (body: FinalizeWebhookPayload<Record<string, unknown>, {
+    id: string;
+    type: string;
+}, Record<string, unknown>, Record<string, unknown>>, e: APIGatewayProxyEventV2) => Promise<WebhookFinalizeTaskConfiguration>;
+type AuthHandler = (body: AuthPayload, e: APIGatewayProxyEventV2) => Promise<AuthHandlerResponse<Record<string, unknown>>>;
+type FetchBackendDataHandler = (body: FetchBackendDataPayload<Record<string, unknown>, Record<string, unknown>>, e: APIGatewayProxyEventV2) => Promise<FetchBackendDataHandlerResponse>;
+export declare const routeWebhookRequests: (handlers: {
+    configurator?: {
+        onFetchBackendData?: FetchBackendDataHandler;
+        onCallback?: CallbackHandler;
+        onFinalize?: FinalizeHandler;
+    };
+    admin?: {
+        onFinalize?: FinalizeHandler;
+    };
+    onAuth?: AuthHandler;
+}, logger: Logger) => (event: APIGatewayProxyEventV2) => Promise<LambdaFunctionURLResult>;
+export {};

package/dist/webhook/implementation/webhook-routing.js

@@ -0,0 +1 @@
+import{P as o,match as t}from"ts-pattern";import{ApplicationType as r}from"../../domain/index.js";import{validateTaskConfiguration as n}from"../tasks/index.js";import{AuthPayload as e,CallbackPayload as a,FetchBackendDataPayload as i,FinalizeWebhookPayload as s}from"./webhook-api-types.js";let f="auth",c="finalize",d="callback",h="fetchBackendData";export const getAuthRoute=()=>`?o=${f}`;export const getFinalizeRoute=o=>`?o=${c}&t=${o}`;export const getCallbackRoute=()=>`?o=${d}`;export const getFetchBackendDataRoute=()=>`?o=${h}`;export const handleWebhookSafely=(o,t)=>async r=>{try{return await o(r)}catch(n){let o=`Webhook failed: ${n instanceof Error?n.message:"Unknown error"}`,r="object"==typeof n&&n instanceof Error?n:Error(o);return t.error(o,{},r),{statusCode:500,body:JSON.stringify({message:o})}}};export const routeWebhookRequests=(u,l)=>handleWebhookSafely(async p=>{if(!p.body)throw Error("No body found in the webhook event!");let g=JSON.parse(p.isBase64Encoded?Buffer.from(p.body,"base64").toString():p.body);return t(p.queryStringParameters?.o).with(f,async()=>{if(l.info("Handling auth operation."),!u.onAuth)throw Error("Auth operation is not configured for this webhook!");let o=e.parse(g);return{statusCode:200,body:JSON.stringify(await u.onAuth(o,p))}}).with(d,async()=>{if(l.info("Handling configurator callback operation."),!u.configurator?.onCallback)throw Error("Auth operation is not configured for this webhook!");let o=a.parse(g);return{statusCode:200,body:JSON.stringify(await u.configurator.onCallback(o,p))}}).with(o.union(void 0,c),()=>t(p.queryStringParameters?.t).with(r.Admin,async()=>{if(l.info("Handling admin finalize operation."),!u.admin?.onFinalize)throw Error("Admin finalize operation is not configured for this webhook!");let o=s.parse(g),t=await u.admin.onFinalize(o,p);return n(t),{statusCode:200,body:JSON.stringify(t)}}).with(o.union(void 0,r.Configurator),async()=>{if(l.info("Handling configurator finalize operation."),!u.configurator?.onFinalize)throw Error("Configurator finalize operation is not configured for this webhook!");let o=s.parse(g),t=await u.configurator.onFinalize(o,p);return n(t),{statusCode:200,body:JSON.stringify(t)}}).otherwise(o=>{throw Error(`Can not parse application type - unknown type: ${o}!`)})).with(h,async()=>{if(l.info("Handling fetch backend data operation."),!u.configurator?.onFetchBackendData)throw Error("Fetch backend data operation is not configured for this webhook!");let o=i.parse(g);return{statusCode:200,body:JSON.stringify(await u.configurator.onFetchBackendData(o,p))}}).otherwise(o=>{throw Error(`Can not parse webhook operation - unknown operation: ${o}!`)})},l);