@macro-inc/sdk 0.0.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 +177 -0
- package/dist/chunk-5HAKQN23.js +1263 -0
- package/dist/chunk-77EI4LSQ.js +2492 -0
- package/dist/chunk-CTKR64MY.js +1436 -0
- package/dist/chunk-JXIQT5TH.js +1467 -0
- package/dist/chunk-P4DTO6VD.js +830 -0
- package/dist/chunk-PAAFJYGO.js +967 -0
- package/dist/chunk-QNUS5BC5.js +913 -0
- package/dist/chunk-SGAHIERJ.js +1235 -0
- package/dist/chunk-V45LUJDI.js +838 -0
- package/dist/chunk-YRUXFEZM.js +1044 -0
- package/dist/generated/agent-harness/client/client.gen.d.ts +2 -0
- package/dist/generated/agent-harness/client/index.d.ts +10 -0
- package/dist/generated/agent-harness/client/types.gen.d.ts +120 -0
- package/dist/generated/agent-harness/client/utils.gen.d.ts +37 -0
- package/dist/generated/agent-harness/client.gen.d.ts +12 -0
- package/dist/generated/agent-harness/core/auth.gen.d.ts +25 -0
- package/dist/generated/agent-harness/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/agent-harness/core/params.gen.d.ts +43 -0
- package/dist/generated/agent-harness/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/agent-harness/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/agent-harness/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/agent-harness/core/types.gen.d.ts +83 -0
- package/dist/generated/agent-harness/core/utils.gen.d.ts +19 -0
- package/dist/generated/agent-harness/index.d.ts +2 -0
- package/dist/generated/agent-harness/index.js +6 -0
- package/dist/generated/agent-harness/sdk.gen.d.ts +84 -0
- package/dist/generated/agent-harness/types.gen.d.ts +539 -0
- package/dist/generated/auth/client/client.gen.d.ts +2 -0
- package/dist/generated/auth/client/index.d.ts +10 -0
- package/dist/generated/auth/client/types.gen.d.ts +120 -0
- package/dist/generated/auth/client/utils.gen.d.ts +37 -0
- package/dist/generated/auth/client.gen.d.ts +12 -0
- package/dist/generated/auth/core/auth.gen.d.ts +25 -0
- package/dist/generated/auth/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/auth/core/params.gen.d.ts +43 -0
- package/dist/generated/auth/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/auth/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/auth/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/auth/core/types.gen.d.ts +83 -0
- package/dist/generated/auth/core/utils.gen.d.ts +19 -0
- package/dist/generated/auth/index.d.ts +2 -0
- package/dist/generated/auth/index.js +6 -0
- package/dist/generated/auth/sdk.gen.d.ts +383 -0
- package/dist/generated/auth/types.gen.d.ts +2175 -0
- package/dist/generated/cognition/client/client.gen.d.ts +2 -0
- package/dist/generated/cognition/client/index.d.ts +10 -0
- package/dist/generated/cognition/client/types.gen.d.ts +120 -0
- package/dist/generated/cognition/client/utils.gen.d.ts +37 -0
- package/dist/generated/cognition/client.gen.d.ts +12 -0
- package/dist/generated/cognition/core/auth.gen.d.ts +25 -0
- package/dist/generated/cognition/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/cognition/core/params.gen.d.ts +43 -0
- package/dist/generated/cognition/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/cognition/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/cognition/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/cognition/core/types.gen.d.ts +83 -0
- package/dist/generated/cognition/core/utils.gen.d.ts +19 -0
- package/dist/generated/cognition/index.d.ts +2 -0
- package/dist/generated/cognition/index.js +6 -0
- package/dist/generated/cognition/sdk.gen.d.ts +224 -0
- package/dist/generated/cognition/types.gen.d.ts +2484 -0
- package/dist/generated/connection/client/client.gen.d.ts +2 -0
- package/dist/generated/connection/client/index.d.ts +10 -0
- package/dist/generated/connection/client/types.gen.d.ts +120 -0
- package/dist/generated/connection/client/utils.gen.d.ts +37 -0
- package/dist/generated/connection/client.gen.d.ts +12 -0
- package/dist/generated/connection/core/auth.gen.d.ts +25 -0
- package/dist/generated/connection/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/connection/core/params.gen.d.ts +43 -0
- package/dist/generated/connection/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/connection/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/connection/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/connection/core/types.gen.d.ts +83 -0
- package/dist/generated/connection/core/utils.gen.d.ts +19 -0
- package/dist/generated/connection/index.d.ts +2 -0
- package/dist/generated/connection/index.js +839 -0
- package/dist/generated/connection/sdk.gen.d.ts +38 -0
- package/dist/generated/connection/types.gen.d.ts +235 -0
- package/dist/generated/contacts/client/client.gen.d.ts +2 -0
- package/dist/generated/contacts/client/index.d.ts +10 -0
- package/dist/generated/contacts/client/types.gen.d.ts +120 -0
- package/dist/generated/contacts/client/utils.gen.d.ts +37 -0
- package/dist/generated/contacts/client.gen.d.ts +12 -0
- package/dist/generated/contacts/core/auth.gen.d.ts +25 -0
- package/dist/generated/contacts/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/contacts/core/params.gen.d.ts +43 -0
- package/dist/generated/contacts/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/contacts/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/contacts/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/contacts/core/types.gen.d.ts +83 -0
- package/dist/generated/contacts/core/utils.gen.d.ts +19 -0
- package/dist/generated/contacts/index.d.ts +2 -0
- package/dist/generated/contacts/index.js +6 -0
- package/dist/generated/contacts/sdk.gen.d.ts +43 -0
- package/dist/generated/contacts/types.gen.d.ts +52 -0
- package/dist/generated/email/client/client.gen.d.ts +2 -0
- package/dist/generated/email/client/index.d.ts +10 -0
- package/dist/generated/email/client/types.gen.d.ts +120 -0
- package/dist/generated/email/client/utils.gen.d.ts +37 -0
- package/dist/generated/email/client.gen.d.ts +12 -0
- package/dist/generated/email/core/auth.gen.d.ts +25 -0
- package/dist/generated/email/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/email/core/params.gen.d.ts +43 -0
- package/dist/generated/email/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/email/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/email/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/email/core/types.gen.d.ts +83 -0
- package/dist/generated/email/core/utils.gen.d.ts +19 -0
- package/dist/generated/email/index.d.ts +2 -0
- package/dist/generated/email/index.js +6 -0
- package/dist/generated/email/sdk.gen.d.ts +254 -0
- package/dist/generated/email/types.gen.d.ts +2614 -0
- package/dist/generated/notification/client/client.gen.d.ts +2 -0
- package/dist/generated/notification/client/index.d.ts +10 -0
- package/dist/generated/notification/client/types.gen.d.ts +120 -0
- package/dist/generated/notification/client/utils.gen.d.ts +37 -0
- package/dist/generated/notification/client.gen.d.ts +12 -0
- package/dist/generated/notification/core/auth.gen.d.ts +25 -0
- package/dist/generated/notification/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/notification/core/params.gen.d.ts +43 -0
- package/dist/generated/notification/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/notification/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/notification/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/notification/core/types.gen.d.ts +83 -0
- package/dist/generated/notification/core/utils.gen.d.ts +19 -0
- package/dist/generated/notification/index.d.ts +2 -0
- package/dist/generated/notification/index.js +6 -0
- package/dist/generated/notification/sdk.gen.d.ts +118 -0
- package/dist/generated/notification/types.gen.d.ts +1352 -0
- package/dist/generated/properties/client/client.gen.d.ts +2 -0
- package/dist/generated/properties/client/index.d.ts +10 -0
- package/dist/generated/properties/client/types.gen.d.ts +120 -0
- package/dist/generated/properties/client/utils.gen.d.ts +37 -0
- package/dist/generated/properties/client.gen.d.ts +12 -0
- package/dist/generated/properties/core/auth.gen.d.ts +25 -0
- package/dist/generated/properties/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/properties/core/params.gen.d.ts +43 -0
- package/dist/generated/properties/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/properties/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/properties/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/properties/core/types.gen.d.ts +83 -0
- package/dist/generated/properties/core/utils.gen.d.ts +19 -0
- package/dist/generated/properties/index.d.ts +2 -0
- package/dist/generated/properties/index.js +6 -0
- package/dist/generated/properties/sdk.gen.d.ts +158 -0
- package/dist/generated/properties/types.gen.d.ts +1288 -0
- package/dist/generated/scheduled-action/client/client.gen.d.ts +2 -0
- package/dist/generated/scheduled-action/client/index.d.ts +10 -0
- package/dist/generated/scheduled-action/client/types.gen.d.ts +120 -0
- package/dist/generated/scheduled-action/client/utils.gen.d.ts +37 -0
- package/dist/generated/scheduled-action/client.gen.d.ts +12 -0
- package/dist/generated/scheduled-action/core/auth.gen.d.ts +25 -0
- package/dist/generated/scheduled-action/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/scheduled-action/core/params.gen.d.ts +43 -0
- package/dist/generated/scheduled-action/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/scheduled-action/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/scheduled-action/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/scheduled-action/core/types.gen.d.ts +83 -0
- package/dist/generated/scheduled-action/core/utils.gen.d.ts +19 -0
- package/dist/generated/scheduled-action/index.d.ts +2 -0
- package/dist/generated/scheduled-action/index.js +845 -0
- package/dist/generated/scheduled-action/sdk.gen.d.ts +42 -0
- package/dist/generated/scheduled-action/types.gen.d.ts +241 -0
- package/dist/generated/search/client/client.gen.d.ts +2 -0
- package/dist/generated/search/client/index.d.ts +10 -0
- package/dist/generated/search/client/types.gen.d.ts +120 -0
- package/dist/generated/search/client/utils.gen.d.ts +37 -0
- package/dist/generated/search/client.gen.d.ts +12 -0
- package/dist/generated/search/core/auth.gen.d.ts +25 -0
- package/dist/generated/search/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/search/core/params.gen.d.ts +43 -0
- package/dist/generated/search/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/search/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/search/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/search/core/types.gen.d.ts +83 -0
- package/dist/generated/search/core/utils.gen.d.ts +19 -0
- package/dist/generated/search/index.d.ts +2 -0
- package/dist/generated/search/index.js +6 -0
- package/dist/generated/search/sdk.gen.d.ts +44 -0
- package/dist/generated/search/types.gen.d.ts +2194 -0
- package/dist/generated/static-files/client/client.gen.d.ts +2 -0
- package/dist/generated/static-files/client/index.d.ts +10 -0
- package/dist/generated/static-files/client/types.gen.d.ts +120 -0
- package/dist/generated/static-files/client/utils.gen.d.ts +37 -0
- package/dist/generated/static-files/client.gen.d.ts +12 -0
- package/dist/generated/static-files/core/auth.gen.d.ts +25 -0
- package/dist/generated/static-files/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/static-files/core/params.gen.d.ts +43 -0
- package/dist/generated/static-files/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/static-files/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/static-files/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/static-files/core/types.gen.d.ts +83 -0
- package/dist/generated/static-files/core/utils.gen.d.ts +19 -0
- package/dist/generated/static-files/index.d.ts +2 -0
- package/dist/generated/static-files/index.js +842 -0
- package/dist/generated/static-files/sdk.gen.d.ts +43 -0
- package/dist/generated/static-files/types.gen.d.ts +214 -0
- package/dist/generated/storage/client/client.gen.d.ts +2 -0
- package/dist/generated/storage/client/index.d.ts +10 -0
- package/dist/generated/storage/client/types.gen.d.ts +120 -0
- package/dist/generated/storage/client/utils.gen.d.ts +37 -0
- package/dist/generated/storage/client.gen.d.ts +12 -0
- package/dist/generated/storage/core/auth.gen.d.ts +25 -0
- package/dist/generated/storage/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/storage/core/params.gen.d.ts +43 -0
- package/dist/generated/storage/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/storage/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/storage/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/storage/core/types.gen.d.ts +83 -0
- package/dist/generated/storage/core/utils.gen.d.ts +19 -0
- package/dist/generated/storage/index.d.ts +2 -0
- package/dist/generated/storage/index.js +6 -0
- package/dist/generated/storage/sdk.gen.d.ts +858 -0
- package/dist/generated/storage/types.gen.d.ts +12105 -0
- package/dist/generated/unfurl/client/client.gen.d.ts +2 -0
- package/dist/generated/unfurl/client/index.d.ts +10 -0
- package/dist/generated/unfurl/client/types.gen.d.ts +120 -0
- package/dist/generated/unfurl/client/utils.gen.d.ts +37 -0
- package/dist/generated/unfurl/client.gen.d.ts +12 -0
- package/dist/generated/unfurl/core/auth.gen.d.ts +25 -0
- package/dist/generated/unfurl/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/unfurl/core/params.gen.d.ts +43 -0
- package/dist/generated/unfurl/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/unfurl/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/unfurl/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/unfurl/core/types.gen.d.ts +83 -0
- package/dist/generated/unfurl/core/utils.gen.d.ts +19 -0
- package/dist/generated/unfurl/index.d.ts +2 -0
- package/dist/generated/unfurl/index.js +835 -0
- package/dist/generated/unfurl/sdk.gen.d.ts +47 -0
- package/dist/generated/unfurl/types.gen.d.ts +125 -0
- package/dist/src/config.d.ts +51 -0
- package/dist/src/entities/agent-sessions/agent-session.d.ts +45 -0
- package/dist/src/entities/agent-sessions/namespace.d.ts +18 -0
- package/dist/src/entities/bots/namespace.d.ts +25 -0
- package/dist/src/entities/calls/call-record.d.ts +55 -0
- package/dist/src/entities/calls/namespace.d.ts +9 -0
- package/dist/src/entities/channels/channel.d.ts +88 -0
- package/dist/src/entities/channels/message.d.ts +64 -0
- package/dist/src/entities/channels/namespace.d.ts +30 -0
- package/dist/src/entities/channels/post.d.ts +20 -0
- package/dist/src/entities/channels/thread.d.ts +30 -0
- package/dist/src/entities/chats/chat.d.ts +55 -0
- package/dist/src/entities/chats/namespace.d.ts +14 -0
- package/dist/src/entities/crm/comment.d.ts +43 -0
- package/dist/src/entities/crm/company.d.ts +70 -0
- package/dist/src/entities/crm/contact.d.ts +48 -0
- package/dist/src/entities/crm/namespace.d.ts +22 -0
- package/dist/src/entities/documents/comment.d.ts +41 -0
- package/dist/src/entities/documents/document.d.ts +130 -0
- package/dist/src/entities/documents/namespace.d.ts +43 -0
- package/dist/src/entities/documents/system-skill.d.ts +16 -0
- package/dist/src/entities/email/attachment.d.ts +36 -0
- package/dist/src/entities/email/label.d.ts +31 -0
- package/dist/src/entities/email/link.d.ts +29 -0
- package/dist/src/entities/email/message.d.ts +58 -0
- package/dist/src/entities/email/namespace.d.ts +49 -0
- package/dist/src/entities/email/thread.d.ts +88 -0
- package/dist/src/entities/entity.d.ts +101 -0
- package/dist/src/entities/favorites/namespace.d.ts +19 -0
- package/dist/src/entities/foreign/foreign-entity.d.ts +30 -0
- package/dist/src/entities/foreign/namespace.d.ts +7 -0
- package/dist/src/entities/notifications/namespace.d.ts +29 -0
- package/dist/src/entities/notifications/notification.d.ts +50 -0
- package/dist/src/entities/pins/namespace.d.ts +19 -0
- package/dist/src/entities/projects/namespace.d.ts +13 -0
- package/dist/src/entities/projects/project.d.ts +42 -0
- package/dist/src/entities/properties/namespace.d.ts +47 -0
- package/dist/src/entities/properties/property-definition.d.ts +45 -0
- package/dist/src/entities/properties/property-option.d.ts +32 -0
- package/dist/src/entities/search.d.ts +23 -0
- package/dist/src/entities/tasks/namespace.d.ts +21 -0
- package/dist/src/entities/tasks/task.d.ts +34 -0
- package/dist/src/entities/teams/namespace.d.ts +12 -0
- package/dist/src/entities/teams/team.d.ts +40 -0
- package/dist/src/entities/users/namespace.d.ts +10 -0
- package/dist/src/entities/users/user.d.ts +43 -0
- package/dist/src/entities/webhooks/namespace.d.ts +31 -0
- package/dist/src/entities/webhooks/webhook.d.ts +88 -0
- package/dist/src/events/hydrate/channel.d.ts +85 -0
- package/dist/src/events/hydrate/document.d.ts +54 -0
- package/dist/src/events/receiver.d.ts +51 -0
- package/dist/src/events/types.d.ts +40 -0
- package/dist/src/events/verify.d.ts +13 -0
- package/dist/src/local-portmap.d.ts +8 -0
- package/dist/src/macro.d.ts +62 -0
- package/dist/src/macro.js +4215 -0
- package/dist/src/mentions.d.ts +37 -0
- package/dist/src/raw.d.ts +12 -0
- package/dist/src/utils/client.d.ts +53 -0
- package/dist/src/utils/index.d.ts +4 -0
- package/dist/src/utils/lazy.d.ts +18 -0
- package/dist/src/utils/pagination.d.ts +7 -0
- package/dist/src/utils/unwrap.d.ts +23 -0
- package/package.json +49 -0
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import type { SimpleMention } from '../generated/storage/types.gen';
|
|
2
|
+
export type { SimpleMention };
|
|
3
|
+
/** The two things a mentionable entity contributes to a message. */
|
|
4
|
+
export interface MentionPart {
|
|
5
|
+
/** The `<m-*>` tag written into the message content. */
|
|
6
|
+
tag: string;
|
|
7
|
+
/** The parallel entry the backend uses for notifications and permissions. */
|
|
8
|
+
mention: SimpleMention;
|
|
9
|
+
}
|
|
10
|
+
/** Anything that can be dropped into a {@link msg} template as a mention. */
|
|
11
|
+
export interface Mentionable {
|
|
12
|
+
toMention(): MentionPart;
|
|
13
|
+
}
|
|
14
|
+
/** What may be interpolated into a {@link msg} template: a mention, or plain text. */
|
|
15
|
+
export type Interpolation = Mentionable | string | number;
|
|
16
|
+
/** A composed message body: content with embedded tags, and the matching mentions. */
|
|
17
|
+
export interface RichMessage {
|
|
18
|
+
content: string;
|
|
19
|
+
mentions: SimpleMention[];
|
|
20
|
+
}
|
|
21
|
+
/** Serialize a mention node to its `<tag>{json}</tag>` wire form. */
|
|
22
|
+
export declare function wrapXml(tag: string, data: unknown): string;
|
|
23
|
+
/** The `@here` group mention. */
|
|
24
|
+
export declare const here: Mentionable;
|
|
25
|
+
/**
|
|
26
|
+
* Compose a rich message. Interpolate mentions (a {@link User}, {@link Document},
|
|
27
|
+
* {@link here}, …) or plain strings. Each mention writes its `<m-*>` tag into the
|
|
28
|
+
* content *and* adds itself to `mentions[]`, so the two can never drift; strings
|
|
29
|
+
* are inserted as-is, so markdown like `**bold**` passes through untouched.
|
|
30
|
+
*
|
|
31
|
+
* @example
|
|
32
|
+
* channel.send(msg`Hey ${user}, see ${doc}. cc ${here}`);
|
|
33
|
+
* channel.send(msg`Status: ${status} — see ${doc}`);
|
|
34
|
+
*/
|
|
35
|
+
export declare function msg(strings: TemplateStringsArray, ...values: Interpolation[]): RichMessage;
|
|
36
|
+
/** Normalize a plain string or a {@link RichMessage} to the wire shape. */
|
|
37
|
+
export declare function toBody(body: string | RichMessage): RichMessage;
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
export * as auth from '../generated/auth';
|
|
2
|
+
export * as cognition from '../generated/cognition';
|
|
3
|
+
export * as connection from '../generated/connection';
|
|
4
|
+
export * as contacts from '../generated/contacts';
|
|
5
|
+
export * as email from '../generated/email';
|
|
6
|
+
export * as notification from '../generated/notification';
|
|
7
|
+
export * as properties from '../generated/properties';
|
|
8
|
+
export * as scheduledAction from '../generated/scheduled-action';
|
|
9
|
+
export * as search from '../generated/search';
|
|
10
|
+
export * as staticFiles from '../generated/static-files';
|
|
11
|
+
export * as storage from '../generated/storage';
|
|
12
|
+
export * as unfurl from '../generated/unfurl';
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
import { Sdk as AgentHarnessSdk } from '../../generated/agent-harness/sdk.gen';
|
|
2
|
+
import { Sdk as AuthSdk } from '../../generated/auth/sdk.gen';
|
|
3
|
+
import { Sdk as CognitionSdk } from '../../generated/cognition/sdk.gen';
|
|
4
|
+
import { Sdk as ContactsSdk } from '../../generated/contacts/sdk.gen';
|
|
5
|
+
import { Sdk as EmailSdk } from '../../generated/email/sdk.gen';
|
|
6
|
+
import { Sdk as NotificationSdk } from '../../generated/notification/sdk.gen';
|
|
7
|
+
import { Sdk as PropertiesSdk } from '../../generated/properties/sdk.gen';
|
|
8
|
+
import { Sdk as SearchSdk } from '../../generated/search/sdk.gen';
|
|
9
|
+
import { Sdk as StorageSdk } from '../../generated/storage/sdk.gen';
|
|
10
|
+
import type { Bot } from '../../generated/storage/types.gen';
|
|
11
|
+
import { type MacroAuth, type MacroOpts, type ServiceName } from '../config';
|
|
12
|
+
import { MacroEvents } from '../events/receiver';
|
|
13
|
+
import { type LocalPortmap } from '../local-portmap';
|
|
14
|
+
export declare class MacroClient {
|
|
15
|
+
readonly agentHarness: AgentHarnessSdk;
|
|
16
|
+
readonly auth: AuthSdk;
|
|
17
|
+
readonly cognition: CognitionSdk;
|
|
18
|
+
readonly contacts: ContactsSdk;
|
|
19
|
+
readonly email: EmailSdk;
|
|
20
|
+
readonly notification: NotificationSdk;
|
|
21
|
+
readonly properties: PropertiesSdk;
|
|
22
|
+
readonly search: SearchSdk;
|
|
23
|
+
readonly storage: StorageSdk;
|
|
24
|
+
readonly webAppUrl: string;
|
|
25
|
+
readonly wsVerify?: string;
|
|
26
|
+
readonly events?: MacroEvents;
|
|
27
|
+
/** Resolved authentication config (distinct from `auth`, the auth-service SDK). */
|
|
28
|
+
readonly authConfig: MacroAuth;
|
|
29
|
+
/** Resolved service base urls: env defaults, then the local-stack portmap,
|
|
30
|
+
* then `opts.hosts` overrides. */
|
|
31
|
+
readonly hosts: Record<ServiceName, string>;
|
|
32
|
+
/** The local stack's generated port map; only set when env is `local`. */
|
|
33
|
+
readonly localPortmap?: LocalPortmap;
|
|
34
|
+
private readonly requestedAs?;
|
|
35
|
+
private selfBotRecord?;
|
|
36
|
+
private selfPrincipal?;
|
|
37
|
+
constructor(opts: MacroOpts);
|
|
38
|
+
/** Whether requests have a user identity accepted by acting-user endpoints. */
|
|
39
|
+
hasActingUser(): boolean;
|
|
40
|
+
/**
|
|
41
|
+
* The authenticated bot's own record, fetched once and cached. Bot auth
|
|
42
|
+
* only. Failed lookups are not cached, so a later call retries.
|
|
43
|
+
*/
|
|
44
|
+
selfBot(): Promise<Bot>;
|
|
45
|
+
/**
|
|
46
|
+
* The authenticated caller's mentionable principal — `bot|<uuid>` for bot
|
|
47
|
+
* auth, `macro|<email>` for user auth — fetched once and cached. Failed
|
|
48
|
+
* lookups are not cached, so a later call retries.
|
|
49
|
+
*/
|
|
50
|
+
myPrincipalId(): Promise<string>;
|
|
51
|
+
private makeClient;
|
|
52
|
+
}
|
|
53
|
+
export type { ServiceName };
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A value fetched on first access and cached thereafter. Powers thin entity
|
|
3
|
+
* handles: construction is free, the record is loaded lazily the first time a
|
|
4
|
+
* field is read, and concurrent reads share one in-flight request. Pass a
|
|
5
|
+
* `seed` when the record is already known (from a list or an event) to skip the
|
|
6
|
+
* fetch entirely.
|
|
7
|
+
*/
|
|
8
|
+
export declare class Lazy<T> {
|
|
9
|
+
private readonly loader;
|
|
10
|
+
private value?;
|
|
11
|
+
private inflight?;
|
|
12
|
+
constructor(loader: () => Promise<T>, seed?: T);
|
|
13
|
+
get(): Promise<T>;
|
|
14
|
+
/** The cached value, if already loaded — never triggers a fetch. */
|
|
15
|
+
peek(): T | undefined;
|
|
16
|
+
/** Drop the cached value so the next read refetches. */
|
|
17
|
+
clear(): void;
|
|
18
|
+
}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
/** One page of a cursor-paginated list. */
|
|
2
|
+
export interface Page<T> {
|
|
3
|
+
items: T[];
|
|
4
|
+
nextCursor?: string | null;
|
|
5
|
+
}
|
|
6
|
+
/** Async generator over a cursor-paginated API. Iterate with `for await`. */
|
|
7
|
+
export declare function paginate<T>(fetchPage: (cursor?: string) => Promise<Page<T>>): AsyncGenerator<T>;
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/** Base for every error the SDK throws. */
|
|
2
|
+
export declare class MacroError extends Error {
|
|
3
|
+
constructor(message: string);
|
|
4
|
+
}
|
|
5
|
+
/** A non-2xx HTTP response (Macro API, or a raw fetch like presigned downloads). */
|
|
6
|
+
export declare class MacroApiError extends MacroError {
|
|
7
|
+
readonly status: number;
|
|
8
|
+
readonly data: unknown;
|
|
9
|
+
constructor(status: number, data: unknown);
|
|
10
|
+
}
|
|
11
|
+
/** The API succeeded but the addressed entity doesn't exist in the result. */
|
|
12
|
+
export declare class MacroNotFoundError extends MacroError {
|
|
13
|
+
constructor(message: string);
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* Turn a hey-api `{ data, error, response? }` result into either the success
|
|
17
|
+
* payload or a thrown MacroApiError.
|
|
18
|
+
*/
|
|
19
|
+
export declare function unwrap<TData, TError>(res: {
|
|
20
|
+
data?: TData;
|
|
21
|
+
error?: TError;
|
|
22
|
+
response?: Response;
|
|
23
|
+
}): TData;
|
package/package.json
ADDED
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@macro-inc/sdk",
|
|
3
|
+
"version": "0.0.1",
|
|
4
|
+
"type": "module",
|
|
5
|
+
"description": "Libary for interacting with Macro.com",
|
|
6
|
+
"main": "./dist/src/macro.js",
|
|
7
|
+
"module": "./dist/src/macro.js",
|
|
8
|
+
"types": "./dist/src/macro.d.ts",
|
|
9
|
+
"sideEffects": false,
|
|
10
|
+
"exports": {
|
|
11
|
+
".": {
|
|
12
|
+
"types": "./dist/src/macro.d.ts",
|
|
13
|
+
"import": "./dist/src/macro.js"
|
|
14
|
+
},
|
|
15
|
+
"./generated/*": {
|
|
16
|
+
"types": "./dist/generated/*/index.d.ts",
|
|
17
|
+
"import": "./dist/generated/*/index.js"
|
|
18
|
+
}
|
|
19
|
+
},
|
|
20
|
+
"files": ["dist"],
|
|
21
|
+
"publishConfig": {
|
|
22
|
+
"access": "public"
|
|
23
|
+
},
|
|
24
|
+
"scripts": {
|
|
25
|
+
"sync-specs": "bun scripts/sync-specs.ts",
|
|
26
|
+
"webhook": "bun scripts/webhook.ts",
|
|
27
|
+
"validate-webhook": "bun scripts/validate-webhook.ts",
|
|
28
|
+
"coverage": "bun src/coverage/check.ts",
|
|
29
|
+
"generate": "openapi-ts",
|
|
30
|
+
"build:js": "bun scripts/build.ts",
|
|
31
|
+
"build:types": "tsc -p tsconfig.build.json",
|
|
32
|
+
"build": "bun run build:js && bun run build:types",
|
|
33
|
+
"prepublishOnly": "bun run build",
|
|
34
|
+
"check": "tsc --noEmit",
|
|
35
|
+
"lint": "biome check",
|
|
36
|
+
"format": "biome format --write"
|
|
37
|
+
},
|
|
38
|
+
"dependencies": {
|
|
39
|
+
"ts-pattern": "^5.8.0"
|
|
40
|
+
},
|
|
41
|
+
"devDependencies": {
|
|
42
|
+
"@biomejs/biome": "2.4.12",
|
|
43
|
+
"@types/bun": "^1.3.5",
|
|
44
|
+
"esbuild": "^0.28.1",
|
|
45
|
+
"hono": "^4.12.27",
|
|
46
|
+
"@hey-api/openapi-ts": "0.99.0",
|
|
47
|
+
"typescript": "^5.9.2"
|
|
48
|
+
}
|
|
49
|
+
}
|