@invoiceleaf/integration-sdk 1.2.0 → 1.5.0
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 +48 -0
- package/dist/context/IntegrationContext.d.ts +169 -0
- package/dist/context/IntegrationContext.d.ts.map +1 -1
- package/dist/helpers/createAttachmentFingerprint.d.ts +11 -0
- package/dist/helpers/createAttachmentFingerprint.d.ts.map +1 -0
- package/dist/helpers/createAttachmentFingerprint.js +14 -0
- package/dist/helpers/createAttachmentFingerprint.js.map +1 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -0
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -264,6 +264,35 @@ Usage in handler:
|
|
|
264
264
|
const apiKey = await context.credentials.getApiKey('openai');
|
|
265
265
|
```
|
|
266
266
|
|
|
267
|
+
## Context APIs for Sync Integrations
|
|
268
|
+
|
|
269
|
+
Use these primitives for Gmail/SMTP and accounting sync integrations:
|
|
270
|
+
|
|
271
|
+
```typescript
|
|
272
|
+
// Durable checkpoints
|
|
273
|
+
await context.state.set('sync:lastSuccessfulAt', new Date().toISOString());
|
|
274
|
+
const checkpoint = await context.state.get<string>('sync:lastSuccessfulAt');
|
|
275
|
+
|
|
276
|
+
// Provider diagnostics (non-secret)
|
|
277
|
+
const connection = await context.credentials.getConnectionInfo('quickbooks');
|
|
278
|
+
|
|
279
|
+
// External ID mappings
|
|
280
|
+
await context.mappings.upsert({
|
|
281
|
+
system: 'quickbooks',
|
|
282
|
+
entity: 'invoice',
|
|
283
|
+
localId: 'doc_123',
|
|
284
|
+
externalId: 'qbo_987',
|
|
285
|
+
});
|
|
286
|
+
|
|
287
|
+
// Document sync metadata
|
|
288
|
+
await context.data.patchDocumentIntegrationMeta({
|
|
289
|
+
documentId: 'doc_123',
|
|
290
|
+
system: 'quickbooks',
|
|
291
|
+
status: 'synced',
|
|
292
|
+
externalId: 'qbo_987',
|
|
293
|
+
});
|
|
294
|
+
```
|
|
295
|
+
|
|
267
296
|
## Custom UI Pages
|
|
268
297
|
|
|
269
298
|
Define custom dashboard pages:
|
|
@@ -352,6 +381,8 @@ const syncEnabled = context.config.syncEnabled as boolean;
|
|
|
352
381
|
| `config` | `Record<string, unknown>` | User configuration |
|
|
353
382
|
| `data` | `DataClient` | Data access client |
|
|
354
383
|
| `credentials` | `CredentialsClient` | Credential client |
|
|
384
|
+
| `state` | `StateClient` | Installation-scoped state client |
|
|
385
|
+
| `email` | `EmailClient` | SMTP/IMAP operations |
|
|
355
386
|
| `logger` | `Logger` | Structured logger |
|
|
356
387
|
|
|
357
388
|
### DataClient
|
|
@@ -366,6 +397,7 @@ const syncEnabled = context.config.syncEnabled as boolean;
|
|
|
366
397
|
| `listTags()` | List all tags |
|
|
367
398
|
| `createExport(params)` | Create export job |
|
|
368
399
|
| `getExport(id)` | Get export status |
|
|
400
|
+
| `importDocument(input)` | Import file as document |
|
|
369
401
|
|
|
370
402
|
### CredentialsClient
|
|
371
403
|
|
|
@@ -375,6 +407,22 @@ const syncEnabled = context.config.syncEnabled as boolean;
|
|
|
375
407
|
| `getApiKey(provider)` | Get API key |
|
|
376
408
|
| `refreshToken(provider)` | Force token refresh |
|
|
377
409
|
|
|
410
|
+
### StateClient
|
|
411
|
+
|
|
412
|
+
| Method | Description |
|
|
413
|
+
|--------|-------------|
|
|
414
|
+
| `get(key)` | Read installation-scoped state |
|
|
415
|
+
| `set(key, value, opts?)` | Persist installation-scoped state |
|
|
416
|
+
| `delete(key)` | Remove installation-scoped state |
|
|
417
|
+
|
|
418
|
+
### EmailClient
|
|
419
|
+
|
|
420
|
+
| Method | Description |
|
|
421
|
+
|--------|-------------|
|
|
422
|
+
| `sendSmtpEmail(input)` | Send outbound SMTP email |
|
|
423
|
+
| `testSmtpImapConnection(input)` | Verify SMTP + IMAP connection |
|
|
424
|
+
| `crawlImapPdfAttachments(input)` | Fetch PDF attachments from IMAP |
|
|
425
|
+
|
|
378
426
|
### Logger
|
|
379
427
|
|
|
380
428
|
| Method | Description |
|
|
@@ -37,6 +37,12 @@ export interface IntegrationContext<TConfig = Record<string, unknown>> {
|
|
|
37
37
|
readonly data: DataClient;
|
|
38
38
|
/** Credential access client */
|
|
39
39
|
readonly credentials: CredentialsClient;
|
|
40
|
+
/** External system mapping client */
|
|
41
|
+
readonly mappings: MappingsClient;
|
|
42
|
+
/** Installation-scoped state storage client */
|
|
43
|
+
readonly state: StateClient;
|
|
44
|
+
/** Email transport and mailbox operations */
|
|
45
|
+
readonly email: EmailClient;
|
|
40
46
|
/** Structured logger */
|
|
41
47
|
readonly logger: Logger;
|
|
42
48
|
}
|
|
@@ -85,6 +91,129 @@ export interface DataClient {
|
|
|
85
91
|
* Get export status by ID.
|
|
86
92
|
*/
|
|
87
93
|
getExport(id: string): Promise<Export>;
|
|
94
|
+
/**
|
|
95
|
+
* Import a file as a new document.
|
|
96
|
+
*/
|
|
97
|
+
importDocument(input: DocumentImportInput): Promise<DocumentImportResult>;
|
|
98
|
+
/**
|
|
99
|
+
* Patch integration sync metadata for a document.
|
|
100
|
+
*/
|
|
101
|
+
patchDocumentIntegrationMeta(input: DocumentIntegrationMetaPatchInput): Promise<void>;
|
|
102
|
+
}
|
|
103
|
+
export interface DocumentImportInput {
|
|
104
|
+
fileName: string;
|
|
105
|
+
contentType: string;
|
|
106
|
+
contentBase64: string;
|
|
107
|
+
source: string;
|
|
108
|
+
description?: string;
|
|
109
|
+
externalRef?: string;
|
|
110
|
+
metadata?: Record<string, unknown>;
|
|
111
|
+
}
|
|
112
|
+
export interface DocumentImportResult {
|
|
113
|
+
documentId: string;
|
|
114
|
+
duplicate: boolean;
|
|
115
|
+
}
|
|
116
|
+
export interface DocumentIntegrationMetaPatchInput {
|
|
117
|
+
documentId: string;
|
|
118
|
+
system: string;
|
|
119
|
+
externalId?: string;
|
|
120
|
+
status?: string;
|
|
121
|
+
lastSyncedAt?: string;
|
|
122
|
+
errorSummary?: string;
|
|
123
|
+
metadata?: Record<string, unknown>;
|
|
124
|
+
}
|
|
125
|
+
export interface StateClient {
|
|
126
|
+
/**
|
|
127
|
+
* Read installation-scoped state value by key.
|
|
128
|
+
*/
|
|
129
|
+
get<T = unknown>(key: string): Promise<T | null>;
|
|
130
|
+
/**
|
|
131
|
+
* Persist installation-scoped state value.
|
|
132
|
+
*/
|
|
133
|
+
set<T = unknown>(key: string, value: T, opts?: {
|
|
134
|
+
ttlSeconds?: number;
|
|
135
|
+
}): Promise<void>;
|
|
136
|
+
/**
|
|
137
|
+
* Delete installation-scoped state value by key.
|
|
138
|
+
*/
|
|
139
|
+
delete(key: string): Promise<void>;
|
|
140
|
+
}
|
|
141
|
+
export interface EmailAttachmentInput {
|
|
142
|
+
fileName: string;
|
|
143
|
+
contentType?: string;
|
|
144
|
+
contentBase64: string;
|
|
145
|
+
}
|
|
146
|
+
export interface SendSmtpEmailInput {
|
|
147
|
+
smtpHost: string;
|
|
148
|
+
smtpPort: number;
|
|
149
|
+
smtpSecure?: boolean;
|
|
150
|
+
smtpUsername: string;
|
|
151
|
+
smtpPassword: string;
|
|
152
|
+
fromAddress: string;
|
|
153
|
+
to: string[];
|
|
154
|
+
cc?: string[];
|
|
155
|
+
bcc?: string[];
|
|
156
|
+
replyTo?: string;
|
|
157
|
+
subject: string;
|
|
158
|
+
text?: string;
|
|
159
|
+
html?: string;
|
|
160
|
+
attachments?: EmailAttachmentInput[];
|
|
161
|
+
}
|
|
162
|
+
export interface SendSmtpEmailResult {
|
|
163
|
+
messageId: string;
|
|
164
|
+
accepted?: string[];
|
|
165
|
+
rejected?: string[];
|
|
166
|
+
response?: string;
|
|
167
|
+
}
|
|
168
|
+
export interface SmtpImapConnectionTestInput {
|
|
169
|
+
smtpHost: string;
|
|
170
|
+
smtpPort: number;
|
|
171
|
+
smtpSecure?: boolean;
|
|
172
|
+
smtpUsername: string;
|
|
173
|
+
smtpPassword: string;
|
|
174
|
+
imapHost: string;
|
|
175
|
+
imapPort: number;
|
|
176
|
+
imapSecure?: boolean;
|
|
177
|
+
imapUsername: string;
|
|
178
|
+
imapPassword: string;
|
|
179
|
+
imapFolder?: string;
|
|
180
|
+
}
|
|
181
|
+
export interface SmtpImapConnectionTestResult {
|
|
182
|
+
smtp: boolean;
|
|
183
|
+
imap: boolean;
|
|
184
|
+
}
|
|
185
|
+
export interface ImapPdfAttachment {
|
|
186
|
+
uid: number;
|
|
187
|
+
fileName: string;
|
|
188
|
+
contentType: string;
|
|
189
|
+
contentBase64: string;
|
|
190
|
+
checksum: string;
|
|
191
|
+
subject?: string;
|
|
192
|
+
from?: string;
|
|
193
|
+
date?: string;
|
|
194
|
+
}
|
|
195
|
+
export interface CrawlImapPdfAttachmentsInput {
|
|
196
|
+
imapHost: string;
|
|
197
|
+
imapPort: number;
|
|
198
|
+
imapSecure?: boolean;
|
|
199
|
+
imapUsername: string;
|
|
200
|
+
imapPassword: string;
|
|
201
|
+
imapFolder?: string;
|
|
202
|
+
searchFilter?: string;
|
|
203
|
+
maxMessagesPerRun?: number;
|
|
204
|
+
maxAttachmentsPerMessage?: number;
|
|
205
|
+
markAsSeen?: boolean;
|
|
206
|
+
moveToFolder?: string;
|
|
207
|
+
}
|
|
208
|
+
export interface CrawlImapPdfAttachmentsResult {
|
|
209
|
+
messages: number;
|
|
210
|
+
attachments: number;
|
|
211
|
+
items: ImapPdfAttachment[];
|
|
212
|
+
}
|
|
213
|
+
export interface EmailClient {
|
|
214
|
+
sendSmtpEmail(input: SendSmtpEmailInput): Promise<SendSmtpEmailResult>;
|
|
215
|
+
testSmtpImapConnection(input: SmtpImapConnectionTestInput): Promise<SmtpImapConnectionTestResult>;
|
|
216
|
+
crawlImapPdfAttachments(input: CrawlImapPdfAttachmentsInput): Promise<CrawlImapPdfAttachmentsResult>;
|
|
88
217
|
}
|
|
89
218
|
/**
|
|
90
219
|
* Client for accessing external service credentials.
|
|
@@ -103,6 +232,46 @@ export interface CredentialsClient {
|
|
|
103
232
|
* Force refresh OAuth2 token.
|
|
104
233
|
*/
|
|
105
234
|
refreshToken(provider: string): Promise<string>;
|
|
235
|
+
/**
|
|
236
|
+
* Get non-secret connection metadata for a provider.
|
|
237
|
+
*/
|
|
238
|
+
getConnectionInfo(provider: string): Promise<CredentialConnectionInfo>;
|
|
239
|
+
}
|
|
240
|
+
export interface CredentialConnectionInfo {
|
|
241
|
+
connected: boolean;
|
|
242
|
+
provider: string;
|
|
243
|
+
credentialType?: 'oauth2' | 'api_key';
|
|
244
|
+
accountEmail?: string;
|
|
245
|
+
accountId?: string;
|
|
246
|
+
accountName?: string;
|
|
247
|
+
scopes?: string[];
|
|
248
|
+
expiresAt?: string;
|
|
249
|
+
valid?: boolean;
|
|
250
|
+
errorMessage?: string;
|
|
251
|
+
}
|
|
252
|
+
export interface MappingRecord {
|
|
253
|
+
system: string;
|
|
254
|
+
entity: string;
|
|
255
|
+
localId: string;
|
|
256
|
+
externalId: string;
|
|
257
|
+
metadata?: Record<string, unknown>;
|
|
258
|
+
}
|
|
259
|
+
export interface MappingGetInput {
|
|
260
|
+
system: string;
|
|
261
|
+
entity: string;
|
|
262
|
+
localId: string;
|
|
263
|
+
}
|
|
264
|
+
export interface MappingFindByExternalInput {
|
|
265
|
+
system: string;
|
|
266
|
+
entity: string;
|
|
267
|
+
externalId: string;
|
|
268
|
+
}
|
|
269
|
+
export interface MappingUpsertInput extends MappingRecord {
|
|
270
|
+
}
|
|
271
|
+
export interface MappingsClient {
|
|
272
|
+
get(input: MappingGetInput): Promise<MappingRecord | null>;
|
|
273
|
+
findByExternal(input: MappingFindByExternalInput): Promise<MappingRecord | null>;
|
|
274
|
+
upsert(input: MappingUpsertInput): Promise<void>;
|
|
106
275
|
}
|
|
107
276
|
/**
|
|
108
277
|
* Structured logger for execution.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"IntegrationContext.d.ts","sourceRoot":"","sources":["../../src/context/IntegrationContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,GAAG,EACH,MAAM,EACN,kBAAkB,EAClB,UAAU,EACV,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,kBAAkB,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnE,uBAAuB;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,sBAAsB;IACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B,+BAA+B;IAC/B,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IAExC,wBAAwB;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,aAAa,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE1E;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE3C;;OAEG;IACH,aAAa,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAEjE;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEzC;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEtC;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE3C;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAE3B;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,OAAO,CAAC,EAAE,kBAAkB,CAAC;KAC9B,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpB;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"IntegrationContext.d.ts","sourceRoot":"","sources":["../../src/context/IntegrationContext.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
export interface AttachmentFingerprintInput {
|
|
2
|
+
uid: number | string;
|
|
3
|
+
fileName: string;
|
|
4
|
+
size?: number;
|
|
5
|
+
sha256?: string;
|
|
6
|
+
}
|
|
7
|
+
/**
|
|
8
|
+
* Builds a deterministic fingerprint used for dedupe/checkpoint keys.
|
|
9
|
+
*/
|
|
10
|
+
export declare function createAttachmentFingerprint(input: AttachmentFingerprintInput): string;
|
|
11
|
+
//# sourceMappingURL=createAttachmentFingerprint.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"createAttachmentFingerprint.d.ts","sourceRoot":"","sources":["../../src/helpers/createAttachmentFingerprint.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,0BAA0B,GAAG,MAAM,CASrF"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { createHash } from 'crypto';
|
|
2
|
+
/**
|
|
3
|
+
* Builds a deterministic fingerprint used for dedupe/checkpoint keys.
|
|
4
|
+
*/
|
|
5
|
+
export function createAttachmentFingerprint(input) {
|
|
6
|
+
const material = [
|
|
7
|
+
String(input.uid),
|
|
8
|
+
input.fileName,
|
|
9
|
+
input.size != null ? String(input.size) : '',
|
|
10
|
+
input.sha256 || '',
|
|
11
|
+
].join(':');
|
|
12
|
+
return createHash('sha256').update(material).digest('hex');
|
|
13
|
+
}
|
|
14
|
+
//# sourceMappingURL=createAttachmentFingerprint.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"createAttachmentFingerprint.js","sourceRoot":"","sources":["../../src/helpers/createAttachmentFingerprint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AASpC;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAAC,KAAiC;IAC3E,MAAM,QAAQ,GAAG;QACf,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;QACjB,KAAK,CAAC,QAAQ;QACd,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE;QAC5C,KAAK,CAAC,MAAM,IAAI,EAAE;KACnB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEZ,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC"}
|
package/dist/index.d.ts
CHANGED
|
@@ -30,5 +30,7 @@ export * from './types/index.js';
|
|
|
30
30
|
export * from './context/index.js';
|
|
31
31
|
export { defineIntegration } from './helpers/defineIntegration.js';
|
|
32
32
|
export { defineHandler } from './helpers/defineHandler.js';
|
|
33
|
+
export { createAttachmentFingerprint } from './helpers/createAttachmentFingerprint.js';
|
|
34
|
+
export type { AttachmentFingerprintInput } from './helpers/createAttachmentFingerprint.js';
|
|
33
35
|
export type { IntegrationHandler, HandlerFunction, DocumentCreatedInput, DocumentUpdatedInput, DocumentProcessedInput, DocumentDeletedInput, CompanyCreatedInput, ExportCompletedInput, ReminderTriggeredInput, WebhookInput, ScheduleInput, UserActionInput, } from './helpers/defineHandler.js';
|
|
34
36
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,cAAc,kBAAkB,CAAC;AAGjC,cAAc,oBAAoB,CAAC;AAGnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,eAAe,GAChB,MAAM,4BAA4B,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,cAAc,kBAAkB,CAAC;AAGjC,cAAc,oBAAoB,CAAC;AAGnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AACvF,YAAY,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AAC3F,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,eAAe,GAChB,MAAM,4BAA4B,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -33,4 +33,5 @@ export * from './context/index.js';
|
|
|
33
33
|
// Helpers
|
|
34
34
|
export { defineIntegration } from './helpers/defineIntegration.js';
|
|
35
35
|
export { defineHandler } from './helpers/defineHandler.js';
|
|
36
|
+
export { createAttachmentFingerprint } from './helpers/createAttachmentFingerprint.js';
|
|
36
37
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,QAAQ;AACR,cAAc,kBAAkB,CAAC;AAEjC,UAAU;AACV,cAAc,oBAAoB,CAAC;AAEnC,UAAU;AACV,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,QAAQ;AACR,cAAc,kBAAkB,CAAC;AAEjC,UAAU;AACV,cAAc,oBAAoB,CAAC;AAEnC,UAAU;AACV,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC"}
|