@lichen-ai/lichen-sdk 0.1.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.
Files changed (122) hide show
  1. package/LICENSE +21 -0
  2. package/dist/auth/error.d.ts +9 -0
  3. package/dist/auth/error.js +76 -0
  4. package/dist/auth/error.js.map +1 -0
  5. package/dist/auth/error.mjs +76 -0
  6. package/dist/auth/error.mjs.map +1 -0
  7. package/dist/auth/index.d.ts +18 -0
  8. package/dist/auth/index.js +35 -0
  9. package/dist/auth/index.js.map +1 -0
  10. package/dist/auth/index.mjs +35 -0
  11. package/dist/auth/index.mjs.map +1 -0
  12. package/dist/auth/types.d.ts +297 -0
  13. package/dist/auth/types.js +2 -0
  14. package/dist/auth/types.js.map +1 -0
  15. package/dist/auth/types.mjs +2 -0
  16. package/dist/auth/types.mjs.map +1 -0
  17. package/dist/client.d.ts +773 -0
  18. package/dist/client.js +1544 -0
  19. package/dist/client.js.map +1 -0
  20. package/dist/client.mjs +1544 -0
  21. package/dist/client.mjs.map +1 -0
  22. package/dist/index.d.ts +7 -0
  23. package/dist/index.js +3 -0
  24. package/dist/index.js.map +1 -0
  25. package/dist/index.mjs +3 -0
  26. package/dist/index.mjs.map +1 -0
  27. package/dist/logging/index.d.ts +43 -0
  28. package/dist/logging/index.js +33 -0
  29. package/dist/logging/index.js.map +1 -0
  30. package/dist/logging/index.mjs +33 -0
  31. package/dist/logging/index.mjs.map +1 -0
  32. package/dist/schema.d.ts +661 -0
  33. package/dist/schema.js +30 -0
  34. package/dist/schema.js.map +1 -0
  35. package/dist/schema.mjs +30 -0
  36. package/dist/schema.mjs.map +1 -0
  37. package/dist/singletons/fetch.d.ts +7 -0
  38. package/dist/singletons/fetch.js +24 -0
  39. package/dist/singletons/fetch.js.map +1 -0
  40. package/dist/singletons/fetch.mjs +24 -0
  41. package/dist/singletons/fetch.mjs.map +1 -0
  42. package/dist/tests/fetch.test.d.ts +1 -0
  43. package/dist/tests/fetch.test.js +460 -0
  44. package/dist/tests/fetch.test.js.map +1 -0
  45. package/dist/tests/fetch.test.mjs +460 -0
  46. package/dist/tests/fetch.test.mjs.map +1 -0
  47. package/dist/tests/sse.test.d.ts +1 -0
  48. package/dist/tests/sse.test.js +132 -0
  49. package/dist/tests/sse.test.js.map +1 -0
  50. package/dist/tests/sse.test.mjs +132 -0
  51. package/dist/tests/sse.test.mjs.map +1 -0
  52. package/dist/types.d.ts +178 -0
  53. package/dist/types.js +2 -0
  54. package/dist/types.js.map +1 -0
  55. package/dist/types.messages.d.ts +86 -0
  56. package/dist/types.messages.js +2 -0
  57. package/dist/types.messages.js.map +1 -0
  58. package/dist/types.messages.mjs +2 -0
  59. package/dist/types.messages.mjs.map +1 -0
  60. package/dist/types.mjs +2 -0
  61. package/dist/types.mjs.map +1 -0
  62. package/dist/types.stream.d.ts +212 -0
  63. package/dist/types.stream.js +2 -0
  64. package/dist/types.stream.js.map +1 -0
  65. package/dist/types.stream.mjs +2 -0
  66. package/dist/types.stream.mjs.map +1 -0
  67. package/dist/ui/branching.d.ts +35 -0
  68. package/dist/ui/branching.js +143 -0
  69. package/dist/ui/branching.js.map +1 -0
  70. package/dist/ui/branching.mjs +143 -0
  71. package/dist/ui/branching.mjs.map +1 -0
  72. package/dist/ui/branching.test.d.ts +1 -0
  73. package/dist/ui/branching.test.js +369 -0
  74. package/dist/ui/branching.test.js.map +1 -0
  75. package/dist/ui/branching.test.mjs +369 -0
  76. package/dist/ui/branching.test.mjs.map +1 -0
  77. package/dist/ui/errors.d.ts +12 -0
  78. package/dist/ui/errors.js +10 -0
  79. package/dist/ui/errors.js.map +1 -0
  80. package/dist/ui/errors.mjs +10 -0
  81. package/dist/ui/errors.mjs.map +1 -0
  82. package/dist/ui/manager.d.ts +87 -0
  83. package/dist/ui/manager.js +158 -0
  84. package/dist/ui/manager.js.map +1 -0
  85. package/dist/ui/manager.mjs +158 -0
  86. package/dist/ui/manager.mjs.map +1 -0
  87. package/dist/ui/messages.d.ts +18 -0
  88. package/dist/ui/messages.js +64 -0
  89. package/dist/ui/messages.js.map +1 -0
  90. package/dist/ui/messages.mjs +64 -0
  91. package/dist/ui/messages.mjs.map +1 -0
  92. package/dist/ui/utils.d.ts +2 -0
  93. package/dist/ui/utils.js +11 -0
  94. package/dist/ui/utils.js.map +1 -0
  95. package/dist/ui/utils.mjs +11 -0
  96. package/dist/ui/utils.mjs.map +1 -0
  97. package/dist/utils/async_caller.d.ts +48 -0
  98. package/dist/utils/async_caller.js +153 -0
  99. package/dist/utils/async_caller.js.map +1 -0
  100. package/dist/utils/async_caller.mjs +153 -0
  101. package/dist/utils/async_caller.mjs.map +1 -0
  102. package/dist/utils/env.d.ts +1 -0
  103. package/dist/utils/env.js +13 -0
  104. package/dist/utils/env.js.map +1 -0
  105. package/dist/utils/env.mjs +13 -0
  106. package/dist/utils/env.mjs.map +1 -0
  107. package/dist/utils/signals.d.ts +1 -0
  108. package/dist/utils/signals.js +19 -0
  109. package/dist/utils/signals.js.map +1 -0
  110. package/dist/utils/signals.mjs +19 -0
  111. package/dist/utils/signals.mjs.map +1 -0
  112. package/dist/utils/sse.d.ts +8 -0
  113. package/dist/utils/sse.js +151 -0
  114. package/dist/utils/sse.js.map +1 -0
  115. package/dist/utils/sse.mjs +151 -0
  116. package/dist/utils/sse.mjs.map +1 -0
  117. package/dist/utils/stream.d.ts +13 -0
  118. package/dist/utils/stream.js +109 -0
  119. package/dist/utils/stream.js.map +1 -0
  120. package/dist/utils/stream.mjs +109 -0
  121. package/dist/utils/stream.mjs.map +1 -0
  122. package/package.json +63 -0
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Xpert AI
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,9 @@
1
+ export declare class HTTPException extends Error {
2
+ status: number;
3
+ headers: HeadersInit;
4
+ constructor(status: number, options?: {
5
+ message?: string;
6
+ headers?: HeadersInit;
7
+ cause?: unknown;
8
+ });
9
+ }
@@ -0,0 +1,76 @@
1
+ const HTTP_STATUS_MAPPING = {
2
+ 100: 'Continue',
3
+ 101: 'Switching Protocols',
4
+ 102: 'Processing',
5
+ 103: 'Early Hints',
6
+ 200: 'OK',
7
+ 201: 'Created',
8
+ 202: 'Accepted',
9
+ 203: 'Non-Authoritative Information',
10
+ 204: 'No Content',
11
+ 205: 'Reset Content',
12
+ 206: 'Partial Content',
13
+ 207: 'Multi-Status',
14
+ 208: 'Already Reported',
15
+ 226: 'IM Used',
16
+ 300: 'Multiple Choices',
17
+ 301: 'Moved Permanently',
18
+ 302: 'Found',
19
+ 303: 'See Other',
20
+ 304: 'Not Modified',
21
+ 305: 'Use Proxy',
22
+ 307: 'Temporary Redirect',
23
+ 308: 'Permanent Redirect',
24
+ 400: 'Bad Request',
25
+ 401: 'Unauthorized',
26
+ 402: 'Payment Required',
27
+ 403: 'Forbidden',
28
+ 404: 'Not Found',
29
+ 405: 'Method Not Allowed',
30
+ 406: 'Not Acceptable',
31
+ 407: 'Proxy Authentication Required',
32
+ 408: 'Request Timeout',
33
+ 409: 'Conflict',
34
+ 410: 'Gone',
35
+ 411: 'Length Required',
36
+ 412: 'Precondition Failed',
37
+ 413: 'Request Entity Too Large',
38
+ 414: 'Request-URI Too Long',
39
+ 415: 'Unsupported Media Type',
40
+ 416: 'Requested Range Not Satisfiable',
41
+ 417: 'Expectation Failed',
42
+ 418: "I'm a Teapot",
43
+ 421: 'Misdirected Request',
44
+ 422: 'Unprocessable Entity',
45
+ 423: 'Locked',
46
+ 424: 'Failed Dependency',
47
+ 425: 'Too Early',
48
+ 426: 'Upgrade Required',
49
+ 428: 'Precondition Required',
50
+ 429: 'Too Many Requests',
51
+ 431: 'Request Header Fields Too Large',
52
+ 451: 'Unavailable For Legal Reasons',
53
+ 500: 'Internal Server Error',
54
+ 501: 'Not Implemented',
55
+ 502: 'Bad Gateway',
56
+ 503: 'Service Unavailable',
57
+ 504: 'Gateway Timeout',
58
+ 505: 'HTTP Version Not Supported',
59
+ 506: 'Variant Also Negotiates',
60
+ 507: 'Insufficient Storage',
61
+ 508: 'Loop Detected',
62
+ 510: 'Not Extended',
63
+ 511: 'Network Authentication Required'
64
+ };
65
+ export class HTTPException extends Error {
66
+ status;
67
+ headers;
68
+ constructor(status, options) {
69
+ super(options?.message ?? HTTP_STATUS_MAPPING[status] ?? 'Unknown error', {
70
+ cause: options?.cause
71
+ });
72
+ this.status = status;
73
+ this.headers = options?.headers ?? {};
74
+ }
75
+ }
76
+ //# sourceMappingURL=error.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/auth/error.ts"],"names":[],"mappings":"AAAA,MAAM,mBAAmB,GAA8B;IACrD,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,qBAAqB;IAC1B,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,aAAa;IAClB,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,+BAA+B;IACpC,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,eAAe;IACpB,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,kBAAkB;IACvB,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,kBAAkB;IACvB,GAAG,EAAE,mBAAmB;IACxB,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,oBAAoB;IACzB,GAAG,EAAE,oBAAoB;IACzB,GAAG,EAAE,aAAa;IAClB,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,kBAAkB;IACvB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,oBAAoB;IACzB,GAAG,EAAE,gBAAgB;IACrB,GAAG,EAAE,+BAA+B;IACpC,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,qBAAqB;IAC1B,GAAG,EAAE,0BAA0B;IAC/B,GAAG,EAAE,sBAAsB;IAC3B,GAAG,EAAE,wBAAwB;IAC7B,GAAG,EAAE,iCAAiC;IACtC,GAAG,EAAE,oBAAoB;IACzB,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,qBAAqB;IAC1B,GAAG,EAAE,sBAAsB;IAC3B,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,mBAAmB;IACxB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,kBAAkB;IACvB,GAAG,EAAE,uBAAuB;IAC5B,GAAG,EAAE,mBAAmB;IACxB,GAAG,EAAE,iCAAiC;IACtC,GAAG,EAAE,+BAA+B;IACpC,GAAG,EAAE,uBAAuB;IAC5B,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,aAAa;IAClB,GAAG,EAAE,qBAAqB;IAC1B,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,4BAA4B;IACjC,GAAG,EAAE,yBAAyB;IAC9B,GAAG,EAAE,sBAAsB;IAC3B,GAAG,EAAE,eAAe;IACpB,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,iCAAiC;CACvC,CAAA;AAED,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,MAAM,CAAQ;IAEd,OAAO,CAAa;IAEpB,YAAY,MAAc,EAAE,OAAsE;QAChG,KAAK,CAAC,OAAO,EAAE,OAAO,IAAI,mBAAmB,CAAC,MAAM,CAAC,IAAI,eAAe,EAAE;YACxE,KAAK,EAAE,OAAO,EAAE,KAAK;SACtB,CAAC,CAAA;QACF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,EAAE,CAAA;IACvC,CAAC;CACF"}
@@ -0,0 +1,76 @@
1
+ const HTTP_STATUS_MAPPING = {
2
+ 100: 'Continue',
3
+ 101: 'Switching Protocols',
4
+ 102: 'Processing',
5
+ 103: 'Early Hints',
6
+ 200: 'OK',
7
+ 201: 'Created',
8
+ 202: 'Accepted',
9
+ 203: 'Non-Authoritative Information',
10
+ 204: 'No Content',
11
+ 205: 'Reset Content',
12
+ 206: 'Partial Content',
13
+ 207: 'Multi-Status',
14
+ 208: 'Already Reported',
15
+ 226: 'IM Used',
16
+ 300: 'Multiple Choices',
17
+ 301: 'Moved Permanently',
18
+ 302: 'Found',
19
+ 303: 'See Other',
20
+ 304: 'Not Modified',
21
+ 305: 'Use Proxy',
22
+ 307: 'Temporary Redirect',
23
+ 308: 'Permanent Redirect',
24
+ 400: 'Bad Request',
25
+ 401: 'Unauthorized',
26
+ 402: 'Payment Required',
27
+ 403: 'Forbidden',
28
+ 404: 'Not Found',
29
+ 405: 'Method Not Allowed',
30
+ 406: 'Not Acceptable',
31
+ 407: 'Proxy Authentication Required',
32
+ 408: 'Request Timeout',
33
+ 409: 'Conflict',
34
+ 410: 'Gone',
35
+ 411: 'Length Required',
36
+ 412: 'Precondition Failed',
37
+ 413: 'Request Entity Too Large',
38
+ 414: 'Request-URI Too Long',
39
+ 415: 'Unsupported Media Type',
40
+ 416: 'Requested Range Not Satisfiable',
41
+ 417: 'Expectation Failed',
42
+ 418: "I'm a Teapot",
43
+ 421: 'Misdirected Request',
44
+ 422: 'Unprocessable Entity',
45
+ 423: 'Locked',
46
+ 424: 'Failed Dependency',
47
+ 425: 'Too Early',
48
+ 426: 'Upgrade Required',
49
+ 428: 'Precondition Required',
50
+ 429: 'Too Many Requests',
51
+ 431: 'Request Header Fields Too Large',
52
+ 451: 'Unavailable For Legal Reasons',
53
+ 500: 'Internal Server Error',
54
+ 501: 'Not Implemented',
55
+ 502: 'Bad Gateway',
56
+ 503: 'Service Unavailable',
57
+ 504: 'Gateway Timeout',
58
+ 505: 'HTTP Version Not Supported',
59
+ 506: 'Variant Also Negotiates',
60
+ 507: 'Insufficient Storage',
61
+ 508: 'Loop Detected',
62
+ 510: 'Not Extended',
63
+ 511: 'Network Authentication Required'
64
+ };
65
+ export class HTTPException extends Error {
66
+ status;
67
+ headers;
68
+ constructor(status, options) {
69
+ super(options?.message ?? HTTP_STATUS_MAPPING[status] ?? 'Unknown error', {
70
+ cause: options?.cause
71
+ });
72
+ this.status = status;
73
+ this.headers = options?.headers ?? {};
74
+ }
75
+ }
76
+ //# sourceMappingURL=error.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"error.mjs","sourceRoot":"","sources":["../../src/auth/error.ts"],"names":[],"mappings":"AAAA,MAAM,mBAAmB,GAA8B;IACrD,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,qBAAqB;IAC1B,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,aAAa;IAClB,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,+BAA+B;IACpC,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,eAAe;IACpB,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,kBAAkB;IACvB,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,kBAAkB;IACvB,GAAG,EAAE,mBAAmB;IACxB,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,oBAAoB;IACzB,GAAG,EAAE,oBAAoB;IACzB,GAAG,EAAE,aAAa;IAClB,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,kBAAkB;IACvB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,oBAAoB;IACzB,GAAG,EAAE,gBAAgB;IACrB,GAAG,EAAE,+BAA+B;IACpC,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,qBAAqB;IAC1B,GAAG,EAAE,0BAA0B;IAC/B,GAAG,EAAE,sBAAsB;IAC3B,GAAG,EAAE,wBAAwB;IAC7B,GAAG,EAAE,iCAAiC;IACtC,GAAG,EAAE,oBAAoB;IACzB,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,qBAAqB;IAC1B,GAAG,EAAE,sBAAsB;IAC3B,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,mBAAmB;IACxB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,kBAAkB;IACvB,GAAG,EAAE,uBAAuB;IAC5B,GAAG,EAAE,mBAAmB;IACxB,GAAG,EAAE,iCAAiC;IACtC,GAAG,EAAE,+BAA+B;IACpC,GAAG,EAAE,uBAAuB;IAC5B,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,aAAa;IAClB,GAAG,EAAE,qBAAqB;IAC1B,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,4BAA4B;IACjC,GAAG,EAAE,yBAAyB;IAC9B,GAAG,EAAE,sBAAsB;IAC3B,GAAG,EAAE,eAAe;IACpB,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,iCAAiC;CACvC,CAAA;AAED,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,MAAM,CAAQ;IAEd,OAAO,CAAa;IAEpB,YAAY,MAAc,EAAE,OAAsE;QAChG,KAAK,CAAC,OAAO,EAAE,OAAO,IAAI,mBAAmB,CAAC,MAAM,CAAC,IAAI,eAAe,EAAE;YACxE,KAAK,EAAE,OAAO,EAAE,KAAK;SACtB,CAAC,CAAA;QACF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,EAAE,CAAA;IACvC,CAAC;CACF"}
@@ -0,0 +1,18 @@
1
+ import type { AuthenticateCallback, CallbackEvent, OnCallback, BaseAuthReturn, ToUserLike, BaseUser } from './types.js';
2
+ export declare class Auth<TExtra = {}, // eslint-disable-line @typescript-eslint/ban-types
3
+ TAuthReturn extends BaseAuthReturn = BaseAuthReturn, TUser extends BaseUser = ToUserLike<TAuthReturn>> {
4
+ authenticate<T extends BaseAuthReturn>(cb: AuthenticateCallback<T>): Auth<TExtra, T>;
5
+ on<T extends CallbackEvent>(event: T, callback: OnCallback<T, TUser>): this;
6
+ }
7
+ /**
8
+ * Check if the provided user was provided by LangGraph Studio.
9
+ *
10
+ * By default, if you add custom authorization on your resources, this will also apply to interactions made from the Studio.
11
+ * If you want, you can handle logged-in Studio users in a special way.
12
+ *
13
+ * @param user - The user to check
14
+ * @returns True if the user is a studio user, false otherwise
15
+ */
16
+ export declare function isStudioUser(user: BaseUser): boolean;
17
+ export type { Filters as AuthFilters, EventValueMap as AuthEventValueMap } from './types.js';
18
+ export { HTTPException } from './error.js';
@@ -0,0 +1,35 @@
1
+ export class Auth {
2
+ /**
3
+ * @internal
4
+ * @ignore
5
+ */
6
+ '~handlerCache' = {};
7
+ authenticate(cb) {
8
+ this['~handlerCache'].authenticate = cb;
9
+ return this;
10
+ }
11
+ on(event, callback) {
12
+ this['~handlerCache'].callbacks ??= {};
13
+ const events = Array.isArray(event) ? event : [event];
14
+ for (const event of events) {
15
+ this['~handlerCache'].callbacks[event] = callback;
16
+ }
17
+ return this;
18
+ }
19
+ }
20
+ /**
21
+ * Check if the provided user was provided by LangGraph Studio.
22
+ *
23
+ * By default, if you add custom authorization on your resources, this will also apply to interactions made from the Studio.
24
+ * If you want, you can handle logged-in Studio users in a special way.
25
+ *
26
+ * @param user - The user to check
27
+ * @returns True if the user is a studio user, false otherwise
28
+ */
29
+ export function isStudioUser(user) {
30
+ if ('kind' in user && user.kind === 'StudioUser')
31
+ return true;
32
+ return user.identity === 'langgraph-studio-user';
33
+ }
34
+ export { HTTPException } from "./error.js";
35
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,IAAI;IAKf;;;OAGG;IACH,eAAe,GAGX,EAAE,CAAA;IAEN,YAAY,CAA2B,EAA2B;QAChE,IAAI,CAAC,eAAe,CAAC,CAAC,YAAY,GAAG,EAAE,CAAA;QACvC,OAAO,IAAkC,CAAA;IAC3C,CAAC;IAED,EAAE,CAA0B,KAAQ,EAAE,QAA8B;QAClE,IAAI,CAAC,eAAe,CAAC,CAAC,SAAS,KAAK,EAAE,CAAA;QACtC,MAAM,MAAM,GAAa,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;QAC/D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,eAAe,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,QAAuB,CAAA;QAClE,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,IAAI,MAAM,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,IAAI,CAAA;IAC7D,OAAO,IAAI,CAAC,QAAQ,KAAK,uBAAuB,CAAA;AAClD,CAAC;OAGM,EAAE,aAAa,EAAE"}
@@ -0,0 +1,35 @@
1
+ export class Auth {
2
+ /**
3
+ * @internal
4
+ * @ignore
5
+ */
6
+ '~handlerCache' = {};
7
+ authenticate(cb) {
8
+ this['~handlerCache'].authenticate = cb;
9
+ return this;
10
+ }
11
+ on(event, callback) {
12
+ this['~handlerCache'].callbacks ??= {};
13
+ const events = Array.isArray(event) ? event : [event];
14
+ for (const event of events) {
15
+ this['~handlerCache'].callbacks[event] = callback;
16
+ }
17
+ return this;
18
+ }
19
+ }
20
+ /**
21
+ * Check if the provided user was provided by LangGraph Studio.
22
+ *
23
+ * By default, if you add custom authorization on your resources, this will also apply to interactions made from the Studio.
24
+ * If you want, you can handle logged-in Studio users in a special way.
25
+ *
26
+ * @param user - The user to check
27
+ * @returns True if the user is a studio user, false otherwise
28
+ */
29
+ export function isStudioUser(user) {
30
+ if ('kind' in user && user.kind === 'StudioUser')
31
+ return true;
32
+ return user.identity === 'langgraph-studio-user';
33
+ }
34
+ export { HTTPException } from "./error.mjs";
35
+ //# sourceMappingURL=index.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,IAAI;IAKf;;;OAGG;IACH,eAAe,GAGX,EAAE,CAAA;IAEN,YAAY,CAA2B,EAA2B;QAChE,IAAI,CAAC,eAAe,CAAC,CAAC,YAAY,GAAG,EAAE,CAAA;QACvC,OAAO,IAAkC,CAAA;IAC3C,CAAC;IAED,EAAE,CAA0B,KAAQ,EAAE,QAA8B;QAClE,IAAI,CAAC,eAAe,CAAC,CAAC,SAAS,KAAK,EAAE,CAAA;QACtC,MAAM,MAAM,GAAa,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;QAC/D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,eAAe,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,QAAuB,CAAA;QAClE,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,IAAI,MAAM,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,IAAI,CAAA;IAC7D,OAAO,IAAI,CAAC,QAAQ,KAAK,uBAAuB,CAAA;AAClD,CAAC;OAGM,EAAE,aAAa,EAAE"}
@@ -0,0 +1,297 @@
1
+ type Maybe<T> = T | null | undefined;
2
+ type PromiseMaybe<T> = Promise<T> | T;
3
+ interface AssistantConfig {
4
+ tags?: Maybe<string[]>;
5
+ recursion_limit?: Maybe<number>;
6
+ configurable?: Maybe<{
7
+ thread_id?: Maybe<string>;
8
+ thread_ts?: Maybe<string>;
9
+ [key: string]: unknown;
10
+ }>;
11
+ }
12
+ /**
13
+ * @inline
14
+ */
15
+ interface AssistantCreate {
16
+ assistant_id?: Maybe<string>;
17
+ metadata?: Maybe<Record<string, unknown>>;
18
+ config?: Maybe<AssistantConfig>;
19
+ context?: Maybe<unknown>;
20
+ if_exists?: Maybe<'raise' | 'do_nothing'>;
21
+ name?: Maybe<string>;
22
+ description?: Maybe<string>;
23
+ graph_id: string;
24
+ }
25
+ /**
26
+ * @inline
27
+ */
28
+ interface AssistantRead {
29
+ assistant_id: string;
30
+ metadata?: Maybe<Record<string, unknown>>;
31
+ }
32
+ /**
33
+ * @inline
34
+ */
35
+ interface AssistantUpdate {
36
+ assistant_id: string;
37
+ metadata?: Maybe<Record<string, unknown>>;
38
+ config?: Maybe<AssistantConfig>;
39
+ context?: Maybe<unknown>;
40
+ graph_id?: Maybe<string>;
41
+ name?: Maybe<string>;
42
+ description?: Maybe<string>;
43
+ version?: Maybe<number>;
44
+ }
45
+ /**
46
+ * @inline
47
+ */
48
+ interface AssistantDelete {
49
+ assistant_id: string;
50
+ }
51
+ /**
52
+ * @inline
53
+ */
54
+ interface AssistantSearch {
55
+ graph_id?: Maybe<string>;
56
+ metadata?: Maybe<Record<string, unknown>>;
57
+ limit?: Maybe<number>;
58
+ offset?: Maybe<number>;
59
+ }
60
+ /**
61
+ * @inline
62
+ */
63
+ interface ThreadCreate {
64
+ thread_id?: Maybe<string>;
65
+ metadata?: Maybe<Record<string, unknown>>;
66
+ if_exists?: Maybe<'raise' | 'do_nothing'>;
67
+ }
68
+ /**
69
+ * @inline
70
+ */
71
+ interface ThreadRead {
72
+ thread_id?: Maybe<string>;
73
+ }
74
+ /**
75
+ * @inline
76
+ */
77
+ interface ThreadUpdate {
78
+ thread_id?: Maybe<string>;
79
+ metadata?: Maybe<Record<string, unknown>>;
80
+ action?: Maybe<'interrupt' | 'rollback'>;
81
+ }
82
+ /**
83
+ * @inline
84
+ */
85
+ interface ThreadDelete {
86
+ thread_id?: Maybe<string>;
87
+ run_id?: Maybe<string>;
88
+ }
89
+ /**
90
+ * @inline
91
+ */
92
+ interface ThreadSearch {
93
+ thread_id?: Maybe<string>;
94
+ ids?: Maybe<string[]>;
95
+ status?: Maybe<'idle' | 'busy' | 'interrupted' | 'error' | (string & {})>;
96
+ metadata?: Maybe<Record<string, unknown>>;
97
+ values?: Maybe<Record<string, unknown>>;
98
+ limit?: Maybe<number>;
99
+ offset?: Maybe<number>;
100
+ }
101
+ /**
102
+ * @inline
103
+ */
104
+ interface CronCreate {
105
+ payload?: Maybe<Record<string, unknown>>;
106
+ schedule: string;
107
+ cron_id?: Maybe<string>;
108
+ thread_id?: Maybe<string>;
109
+ user_id?: Maybe<string>;
110
+ end_time?: Maybe<string>;
111
+ }
112
+ /**
113
+ * @inline
114
+ */
115
+ interface CronRead {
116
+ cron_id: string;
117
+ }
118
+ /**
119
+ * @inline
120
+ */
121
+ interface CronUpdate {
122
+ cron_id: string;
123
+ payload?: Maybe<Record<string, unknown>>;
124
+ schedule?: Maybe<string>;
125
+ }
126
+ /**
127
+ * @inline
128
+ */
129
+ interface CronDelete {
130
+ cron_id: string;
131
+ }
132
+ /**
133
+ * @inline
134
+ */
135
+ interface CronSearch {
136
+ assistant_id?: Maybe<string>;
137
+ thread_id?: Maybe<string>;
138
+ limit?: Maybe<number>;
139
+ offset?: Maybe<number>;
140
+ }
141
+ /**
142
+ * @inline
143
+ */
144
+ interface StorePut {
145
+ namespace: string[];
146
+ key: string;
147
+ value: Record<string, unknown>;
148
+ }
149
+ /**
150
+ * @inline
151
+ */
152
+ interface StoreGet {
153
+ namespace: Maybe<string[]>;
154
+ key: string;
155
+ }
156
+ /**
157
+ * @inline
158
+ */
159
+ interface StoreSearch {
160
+ namespace?: Maybe<string[]>;
161
+ filter?: Maybe<Record<string, unknown>>;
162
+ limit?: Maybe<number>;
163
+ offset?: Maybe<number>;
164
+ query?: Maybe<string>;
165
+ }
166
+ /**
167
+ * @inline
168
+ */
169
+ interface StoreListNamespaces {
170
+ namespace?: Maybe<string[]>;
171
+ suffix?: Maybe<string[]>;
172
+ max_depth?: Maybe<number>;
173
+ limit?: Maybe<number>;
174
+ offset?: Maybe<number>;
175
+ }
176
+ /**
177
+ * @inline
178
+ */
179
+ interface StoreDelete {
180
+ namespace?: Maybe<string[]>;
181
+ key: string;
182
+ }
183
+ /**
184
+ * @inline
185
+ */
186
+ interface RunsCreate {
187
+ thread_id?: Maybe<string>;
188
+ assistant_id: string;
189
+ run_id: string;
190
+ status: Maybe<'pending' | 'running' | 'error' | 'success' | 'timeout' | 'interrupted'>;
191
+ metadata?: Maybe<Record<string, unknown>>;
192
+ prevent_insert_if_inflight?: Maybe<boolean>;
193
+ multitask_strategy?: Maybe<'interrupt' | 'rollback' | 'reject' | 'enqueue'>;
194
+ if_not_exists?: Maybe<'reject' | 'create'>;
195
+ after_seconds?: Maybe<number>;
196
+ kwargs: Record<string, unknown>;
197
+ }
198
+ export interface EventValueMap {
199
+ ['threads:create']: ThreadCreate;
200
+ ['threads:read']: ThreadRead;
201
+ ['threads:update']: ThreadUpdate;
202
+ ['threads:delete']: ThreadDelete;
203
+ ['threads:search']: ThreadSearch;
204
+ ['threads:create_run']: RunsCreate;
205
+ ['assistants:create']: AssistantCreate;
206
+ ['assistants:read']: AssistantRead;
207
+ ['assistants:update']: AssistantUpdate;
208
+ ['assistants:delete']: AssistantDelete;
209
+ ['assistants:search']: AssistantSearch;
210
+ ['crons:create']: CronCreate;
211
+ ['crons:read']: CronRead;
212
+ ['crons:update']: CronUpdate;
213
+ ['crons:delete']: CronDelete;
214
+ ['crons:search']: CronSearch;
215
+ ['store:put']: StorePut;
216
+ ['store:get']: StoreGet;
217
+ ['store:search']: StoreSearch;
218
+ ['store:list_namespaces']: StoreListNamespaces;
219
+ ['store:delete']: StoreDelete;
220
+ }
221
+ interface ResourceType {
222
+ threads: 'threads:create' | 'threads:read' | 'threads:update' | 'threads:delete' | 'threads:search' | 'threads:create_run';
223
+ assistants: 'assistants:create' | 'assistants:read' | 'assistants:update' | 'assistants:delete' | 'assistants:search';
224
+ crons: 'crons:create' | 'crons:read' | 'crons:update' | 'crons:delete' | 'crons:search';
225
+ store: 'store:put' | 'store:get' | 'store:search' | 'store:list_namespaces' | 'store:delete';
226
+ }
227
+ interface ActionType {
228
+ '*:create': 'threads:create' | 'assistants:create' | 'crons:create';
229
+ '*:read': 'threads:read' | 'assistants:read' | 'crons:read';
230
+ '*:update': 'threads:update' | 'assistants:update' | 'crons:update';
231
+ '*:delete': 'threads:delete' | 'assistants:delete' | 'crons:delete' | 'store:delete';
232
+ '*:search': 'threads:search' | 'assistants:search' | 'crons:search' | 'store:search';
233
+ '*:create_run': 'threads:create_run';
234
+ '*:put': 'store:put';
235
+ '*:get': 'store:get';
236
+ '*:list_namespaces': 'store:list_namespaces';
237
+ }
238
+ export type BaseAuthReturn = {
239
+ is_authenticated?: boolean;
240
+ display_name?: string;
241
+ identity: string;
242
+ permissions: string[];
243
+ } | string;
244
+ export interface BaseUser {
245
+ is_authenticated: boolean;
246
+ display_name: string;
247
+ identity: string;
248
+ permissions: string[];
249
+ }
250
+ export type ToUserLike<T extends BaseAuthReturn> = T extends string ? {
251
+ is_authenticated: boolean;
252
+ display_name: string;
253
+ identity: string;
254
+ permissions: string[];
255
+ } : Omit<T, 'is_authenticated' | 'display_name'> & {
256
+ is_authenticated: boolean;
257
+ display_name: string;
258
+ };
259
+ type CallbackParameter<Event extends string = string, Resource extends string = string, Action extends string = string, Value = unknown, TUser extends BaseUser = BaseUser> = {
260
+ event: Event;
261
+ resource: Resource;
262
+ action: Action;
263
+ value: Value;
264
+ user: TUser;
265
+ permissions: string[];
266
+ };
267
+ type ContextMap = {
268
+ [EventType in keyof EventValueMap]: CallbackParameter<EventType, EventType extends `${infer Resource}:${string}` ? Resource : never, EventType extends `${string}:${infer Action}` ? Action : never, EventValueMap[EventType], BaseUser>;
269
+ };
270
+ type ActionCallbackParameter<T extends keyof ActionType, TUser extends BaseUser = BaseUser> = ContextMap[ActionType[T]] & {
271
+ user: TUser;
272
+ };
273
+ type AuthCallbackParameter<T extends keyof EventValueMap, TUser extends BaseUser = BaseUser> = ContextMap[T] & {
274
+ user: TUser;
275
+ };
276
+ type ResourceCallbackParameter<T extends keyof ResourceType, TUser extends BaseUser = BaseUser> = ContextMap[ResourceType[T]] & {
277
+ user: TUser;
278
+ };
279
+ export type Filters<TKey extends string | number | symbol> = {
280
+ [key in TKey]: string | {
281
+ [op in '$contains' | '$eq']?: string;
282
+ };
283
+ };
284
+ export interface AuthenticateCallback<T extends BaseAuthReturn> {
285
+ (request: Request): PromiseMaybe<T>;
286
+ }
287
+ type OnKey = keyof ResourceType | keyof ActionType | keyof EventValueMap;
288
+ type OnSingleParameter<T extends OnKey, TUser extends BaseUser = BaseUser> = T extends keyof ResourceType ? ResourceCallbackParameter<T, TUser> : T extends keyof ActionType ? ActionCallbackParameter<T, TUser> : T extends keyof EventValueMap ? AuthCallbackParameter<T, TUser> : never;
289
+ type OnParameter<T extends '*' | OnKey | OnKey[], TUser extends BaseUser = BaseUser> = T extends OnKey[] ? OnSingleParameter<T[number], TUser> : T extends '*' ? AuthCallbackParameter<keyof EventValueMap, TUser> : T extends OnKey ? OnSingleParameter<T, TUser> : never;
290
+ export type AnyCallback = {
291
+ (request: CallbackParameter): void | PromiseMaybe<boolean> | PromiseMaybe<Filters<string>>;
292
+ };
293
+ export type CallbackEvent = '*' | OnKey | OnKey[];
294
+ export type OnCallback<T extends CallbackEvent, TUser extends BaseUser = BaseUser, TMetadata extends Record<string, unknown> = Record<string, unknown>> = {
295
+ (request: OnParameter<T, TUser>): void | PromiseMaybe<boolean> | PromiseMaybe<Filters<keyof TMetadata>>;
296
+ };
297
+ export {};
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/auth/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.mjs","sourceRoot":"","sources":["../../src/auth/types.ts"],"names":[],"mappings":""}