@dxos/functions 0.8.4-main.dedc0f3 → 0.8.4-main.e8ec1fe

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 (190) hide show
  1. package/dist/lib/browser/index.mjs +732 -1070
  2. package/dist/lib/browser/index.mjs.map +4 -4
  3. package/dist/lib/browser/meta.json +1 -1
  4. package/dist/lib/node-esm/index.mjs +732 -1070
  5. package/dist/lib/node-esm/index.mjs.map +4 -4
  6. package/dist/lib/node-esm/meta.json +1 -1
  7. package/dist/types/src/errors.d.ts +47 -55
  8. package/dist/types/src/errors.d.ts.map +1 -1
  9. package/dist/types/src/{examples → example}/fib.d.ts +1 -1
  10. package/dist/types/src/example/fib.d.ts.map +1 -0
  11. package/dist/types/src/example/forex-effect.d.ts +3 -0
  12. package/dist/types/src/example/forex-effect.d.ts.map +1 -0
  13. package/dist/types/src/example/index.d.ts +12 -0
  14. package/dist/types/src/example/index.d.ts.map +1 -0
  15. package/dist/types/src/{examples → example}/reply.d.ts +1 -1
  16. package/dist/types/src/example/reply.d.ts.map +1 -0
  17. package/dist/types/src/{examples → example}/sleep.d.ts +1 -1
  18. package/dist/types/src/example/sleep.d.ts.map +1 -0
  19. package/dist/types/src/index.d.ts +4 -8
  20. package/dist/types/src/index.d.ts.map +1 -1
  21. package/dist/types/src/protocol/index.d.ts +2 -0
  22. package/dist/types/src/protocol/index.d.ts.map +1 -0
  23. package/dist/types/src/protocol/protocol.d.ts +7 -0
  24. package/dist/types/src/protocol/protocol.d.ts.map +1 -0
  25. package/dist/types/src/protocol/protocol.test.d.ts +2 -0
  26. package/dist/types/src/protocol/protocol.test.d.ts.map +1 -0
  27. package/dist/types/src/sdk.d.ts +89 -0
  28. package/dist/types/src/sdk.d.ts.map +1 -0
  29. package/dist/types/src/services/credentials.d.ts +7 -3
  30. package/dist/types/src/services/credentials.d.ts.map +1 -1
  31. package/dist/types/src/services/event-logger.d.ts +20 -5
  32. package/dist/types/src/services/event-logger.d.ts.map +1 -1
  33. package/dist/types/src/services/function-invocation-service.d.ts +11 -0
  34. package/dist/types/src/services/function-invocation-service.d.ts.map +1 -0
  35. package/dist/types/src/services/index.d.ts +6 -6
  36. package/dist/types/src/services/index.d.ts.map +1 -1
  37. package/dist/types/src/services/queues.d.ts +3 -1
  38. package/dist/types/src/services/queues.d.ts.map +1 -1
  39. package/dist/types/src/services/tracing.d.ts +9 -12
  40. package/dist/types/src/services/tracing.d.ts.map +1 -1
  41. package/dist/types/src/types/Function.d.ts +58 -0
  42. package/dist/types/src/types/Function.d.ts.map +1 -0
  43. package/dist/types/src/types/Script.d.ts +28 -0
  44. package/dist/types/src/types/Script.d.ts.map +1 -0
  45. package/dist/types/src/types/Trigger.d.ts +139 -0
  46. package/dist/types/src/types/Trigger.d.ts.map +1 -0
  47. package/dist/types/src/types/TriggerEvent.d.ts +44 -0
  48. package/dist/types/src/types/TriggerEvent.d.ts.map +1 -0
  49. package/dist/types/src/types/index.d.ts +6 -0
  50. package/dist/types/src/types/index.d.ts.map +1 -0
  51. package/dist/types/src/{url.d.ts → types/url.d.ts} +1 -10
  52. package/dist/types/src/types/url.d.ts.map +1 -0
  53. package/dist/types/tsconfig.tsbuildinfo +1 -1
  54. package/package.json +16 -70
  55. package/src/errors.ts +9 -9
  56. package/src/{examples → example}/fib.ts +5 -3
  57. package/src/example/forex-effect.ts +40 -0
  58. package/src/example/index.ts +13 -0
  59. package/src/{examples → example}/reply.ts +6 -3
  60. package/src/{examples → example}/sleep.ts +5 -3
  61. package/src/index.ts +4 -8
  62. package/src/{executor → protocol}/index.ts +1 -1
  63. package/src/protocol/protocol.test.ts +59 -0
  64. package/src/protocol/protocol.ts +145 -0
  65. package/src/sdk.ts +226 -0
  66. package/src/services/credentials.ts +12 -6
  67. package/src/services/event-logger.ts +12 -3
  68. package/src/services/function-invocation-service.ts +23 -0
  69. package/src/services/index.ts +7 -6
  70. package/src/services/queues.ts +3 -1
  71. package/src/services/tracing.ts +24 -56
  72. package/src/{schema.ts → types/Function.ts} +20 -26
  73. package/src/types/Script.ts +33 -0
  74. package/src/types/Trigger.ts +139 -0
  75. package/src/types/TriggerEvent.ts +62 -0
  76. package/src/types/index.ts +9 -0
  77. package/src/types/url.ts +31 -0
  78. package/dist/lib/browser/bundler/index.mjs +0 -265
  79. package/dist/lib/browser/bundler/index.mjs.map +0 -7
  80. package/dist/lib/browser/chunk-ANP3DFCO.mjs +0 -623
  81. package/dist/lib/browser/chunk-ANP3DFCO.mjs.map +0 -7
  82. package/dist/lib/browser/chunk-J5LGTIGS.mjs +0 -10
  83. package/dist/lib/browser/chunk-J5LGTIGS.mjs.map +0 -7
  84. package/dist/lib/browser/edge/index.mjs +0 -83
  85. package/dist/lib/browser/edge/index.mjs.map +0 -7
  86. package/dist/lib/browser/testing/index.mjs +0 -129
  87. package/dist/lib/browser/testing/index.mjs.map +0 -7
  88. package/dist/lib/node-esm/bundler/index.mjs +0 -266
  89. package/dist/lib/node-esm/bundler/index.mjs.map +0 -7
  90. package/dist/lib/node-esm/chunk-HSLMI22Q.mjs +0 -11
  91. package/dist/lib/node-esm/chunk-HSLMI22Q.mjs.map +0 -7
  92. package/dist/lib/node-esm/chunk-MPKVY7ZR.mjs +0 -625
  93. package/dist/lib/node-esm/chunk-MPKVY7ZR.mjs.map +0 -7
  94. package/dist/lib/node-esm/edge/index.mjs +0 -84
  95. package/dist/lib/node-esm/edge/index.mjs.map +0 -7
  96. package/dist/lib/node-esm/testing/index.mjs +0 -130
  97. package/dist/lib/node-esm/testing/index.mjs.map +0 -7
  98. package/dist/types/src/bundler/bundler.d.ts +0 -49
  99. package/dist/types/src/bundler/bundler.d.ts.map +0 -1
  100. package/dist/types/src/bundler/bundler.test.d.ts +0 -2
  101. package/dist/types/src/bundler/bundler.test.d.ts.map +0 -1
  102. package/dist/types/src/bundler/index.d.ts +0 -2
  103. package/dist/types/src/bundler/index.d.ts.map +0 -1
  104. package/dist/types/src/edge/functions.d.ts +0 -17
  105. package/dist/types/src/edge/functions.d.ts.map +0 -1
  106. package/dist/types/src/edge/index.d.ts +0 -2
  107. package/dist/types/src/edge/index.d.ts.map +0 -1
  108. package/dist/types/src/examples/fib.d.ts.map +0 -1
  109. package/dist/types/src/examples/index.d.ts +0 -4
  110. package/dist/types/src/examples/index.d.ts.map +0 -1
  111. package/dist/types/src/examples/reply.d.ts.map +0 -1
  112. package/dist/types/src/examples/sleep.d.ts.map +0 -1
  113. package/dist/types/src/executor/executor.d.ts +0 -11
  114. package/dist/types/src/executor/executor.d.ts.map +0 -1
  115. package/dist/types/src/executor/index.d.ts +0 -2
  116. package/dist/types/src/executor/index.d.ts.map +0 -1
  117. package/dist/types/src/handler.d.ts +0 -94
  118. package/dist/types/src/handler.d.ts.map +0 -1
  119. package/dist/types/src/schema.d.ts +0 -43
  120. package/dist/types/src/schema.d.ts.map +0 -1
  121. package/dist/types/src/services/database.d.ts +0 -98
  122. package/dist/types/src/services/database.d.ts.map +0 -1
  123. package/dist/types/src/services/local-function-execution.d.ts +0 -25
  124. package/dist/types/src/services/local-function-execution.d.ts.map +0 -1
  125. package/dist/types/src/services/remote-function-execution-service.d.ts +0 -15
  126. package/dist/types/src/services/remote-function-execution-service.d.ts.map +0 -1
  127. package/dist/types/src/services/service-container.d.ts +0 -56
  128. package/dist/types/src/services/service-container.d.ts.map +0 -1
  129. package/dist/types/src/services/service-registry.d.ts +0 -29
  130. package/dist/types/src/services/service-registry.d.ts.map +0 -1
  131. package/dist/types/src/services/service-registry.test.d.ts +0 -2
  132. package/dist/types/src/services/service-registry.test.d.ts.map +0 -1
  133. package/dist/types/src/testing/index.d.ts +0 -3
  134. package/dist/types/src/testing/index.d.ts.map +0 -1
  135. package/dist/types/src/testing/layer.d.ts +0 -15
  136. package/dist/types/src/testing/layer.d.ts.map +0 -1
  137. package/dist/types/src/testing/logger.d.ts +0 -5
  138. package/dist/types/src/testing/logger.d.ts.map +0 -1
  139. package/dist/types/src/testing/persist-database.test.d.ts +0 -2
  140. package/dist/types/src/testing/persist-database.test.d.ts.map +0 -1
  141. package/dist/types/src/testing/services.d.ts +0 -59
  142. package/dist/types/src/testing/services.d.ts.map +0 -1
  143. package/dist/types/src/trace.d.ts +0 -122
  144. package/dist/types/src/trace.d.ts.map +0 -1
  145. package/dist/types/src/translations.d.ts +0 -12
  146. package/dist/types/src/translations.d.ts.map +0 -1
  147. package/dist/types/src/triggers/index.d.ts +0 -4
  148. package/dist/types/src/triggers/index.d.ts.map +0 -1
  149. package/dist/types/src/triggers/input-builder.d.ts +0 -3
  150. package/dist/types/src/triggers/input-builder.d.ts.map +0 -1
  151. package/dist/types/src/triggers/invocation-tracer.d.ts +0 -35
  152. package/dist/types/src/triggers/invocation-tracer.d.ts.map +0 -1
  153. package/dist/types/src/triggers/trigger-dispatcher.d.ts +0 -75
  154. package/dist/types/src/triggers/trigger-dispatcher.d.ts.map +0 -1
  155. package/dist/types/src/triggers/trigger-dispatcher.test.d.ts +0 -2
  156. package/dist/types/src/triggers/trigger-dispatcher.test.d.ts.map +0 -1
  157. package/dist/types/src/triggers/trigger-state-store.d.ts +0 -27
  158. package/dist/types/src/triggers/trigger-state-store.d.ts.map +0 -1
  159. package/dist/types/src/types.d.ts +0 -211
  160. package/dist/types/src/types.d.ts.map +0 -1
  161. package/dist/types/src/url.d.ts.map +0 -1
  162. package/src/bundler/bundler.test.ts +0 -58
  163. package/src/bundler/bundler.ts +0 -291
  164. package/src/bundler/index.ts +0 -5
  165. package/src/edge/functions.ts +0 -67
  166. package/src/edge/index.ts +0 -9
  167. package/src/examples/index.ts +0 -7
  168. package/src/executor/executor.ts +0 -54
  169. package/src/handler.ts +0 -201
  170. package/src/services/database.ts +0 -170
  171. package/src/services/local-function-execution.ts +0 -114
  172. package/src/services/remote-function-execution-service.ts +0 -46
  173. package/src/services/service-container.ts +0 -114
  174. package/src/services/service-registry.test.ts +0 -42
  175. package/src/services/service-registry.ts +0 -59
  176. package/src/testing/index.ts +0 -6
  177. package/src/testing/layer.ts +0 -111
  178. package/src/testing/logger.ts +0 -16
  179. package/src/testing/persist-database.test.ts +0 -87
  180. package/src/testing/services.ts +0 -115
  181. package/src/trace.ts +0 -178
  182. package/src/translations.ts +0 -20
  183. package/src/triggers/index.ts +0 -7
  184. package/src/triggers/input-builder.ts +0 -35
  185. package/src/triggers/invocation-tracer.ts +0 -99
  186. package/src/triggers/trigger-dispatcher.test.ts +0 -652
  187. package/src/triggers/trigger-dispatcher.ts +0 -512
  188. package/src/triggers/trigger-state-store.ts +0 -60
  189. package/src/types.ts +0 -200
  190. package/src/url.ts +0 -55
@@ -1,170 +0,0 @@
1
- //
2
- // Copyright 2025 DXOS.org
3
- //
4
-
5
- import { Context, Effect, Layer, Option, type Schema } from 'effect';
6
-
7
- import { type Filter, type Live, Obj, type Query, type Ref, type Relation, type Type } from '@dxos/echo';
8
- import type { EchoDatabase, FlushOptions, OneShotQueryResult, QueryResult, SchemaRegistryQuery } from '@dxos/echo-db';
9
- import type { SchemaRegistryPreparedQuery } from '@dxos/echo-db';
10
- import type { EchoSchema } from '@dxos/echo-schema';
11
- import { promiseWithCauseCapture } from '@dxos/effect';
12
- import { BaseError } from '@dxos/errors';
13
- import { invariant } from '@dxos/invariant';
14
- import type { DXN } from '@dxos/keys';
15
-
16
- export class DatabaseService extends Context.Tag('@dxos/functions/DatabaseService')<
17
- DatabaseService,
18
- {
19
- readonly db: EchoDatabase;
20
- }
21
- >() {
22
- static notAvailable = Layer.succeed(DatabaseService, {
23
- get db(): EchoDatabase {
24
- throw new Error('Database not available');
25
- },
26
- });
27
-
28
- static make = (db: EchoDatabase): Context.Tag.Service<DatabaseService> => {
29
- return {
30
- get db() {
31
- return db;
32
- },
33
- };
34
- };
35
-
36
- static layer = (db: EchoDatabase): Layer.Layer<DatabaseService> => {
37
- return Layer.succeed(DatabaseService, DatabaseService.make(db));
38
- };
39
-
40
- /**
41
- * Resolves an object by its DXN.
42
- */
43
- static resolve: {
44
- // No type check.
45
- (dxn: DXN): Effect.Effect<Obj.Any | Relation.Any, never, DatabaseService>;
46
- // Check matches schema.
47
- <S extends Type.Obj.Any | Type.Relation.Any>(
48
- dxn: DXN,
49
- schema: S,
50
- ): Effect.Effect<Schema.Schema.Type<S>, ObjectNotFoundError, DatabaseService>;
51
- } = (<S extends Type.Obj.Any | Type.Relation.Any>(
52
- dxn: DXN,
53
- schema?: S,
54
- ): Effect.Effect<Schema.Schema.Type<S>, ObjectNotFoundError, DatabaseService> =>
55
- Effect.gen(function* () {
56
- const { db } = yield* DatabaseService;
57
- const object = yield* promiseWithCauseCapture(() =>
58
- db.graph
59
- .createRefResolver({
60
- context: {
61
- space: db.spaceId,
62
- },
63
- })
64
- .resolve(dxn),
65
- );
66
-
67
- if (!object) {
68
- return yield* Effect.fail(new ObjectNotFoundError({ dxn }));
69
- }
70
- invariant(!schema || Obj.instanceOf(schema, object), 'Object type mismatch.');
71
- return object as any;
72
- })) as any;
73
-
74
- /**
75
- * Loads an object reference.
76
- */
77
- static load: <T>(ref: Ref.Ref<T>) => Effect.Effect<T, ObjectNotFoundError, never> = Effect.fn(function* (ref) {
78
- const object = yield* promiseWithCauseCapture(() => ref.tryLoad());
79
- if (!object) {
80
- return yield* Effect.fail(new ObjectNotFoundError({ dxn: ref.dxn }));
81
- }
82
- return object;
83
- });
84
-
85
- /**
86
- * Loads an object reference option.
87
- */
88
- // TODO(burdon): Option?
89
- static loadOption: <T>(ref: Ref.Ref<T>) => Effect.Effect<Option.Option<T>, never, never> = Effect.fn(function* (ref) {
90
- const object = yield* DatabaseService.load(ref).pipe(
91
- Effect.catchTag('OBJECT_NOT_FOUND', () => Effect.succeed(undefined)),
92
- );
93
- return Option.fromNullable(object);
94
- });
95
-
96
- // TODO(burdon): Can we create a proxy for the following methods on EchoDatabase? Use @inheritDoc?
97
- // TODO(burdon): Figure out how to chain query().run();
98
-
99
- /**
100
- * @link EchoDatabase.add
101
- */
102
- static add = <T extends Obj.Any | Relation.Any>(obj: T): Effect.Effect<T, never, DatabaseService> =>
103
- DatabaseService.pipe(Effect.map(({ db }) => db.add(obj)));
104
-
105
- /**
106
- * @link EchoDatabase.remove
107
- */
108
- static remove = <T extends Obj.Any | Relation.Any>(obj: T): Effect.Effect<void, never, DatabaseService> =>
109
- DatabaseService.pipe(Effect.map(({ db }) => db.remove(obj)));
110
-
111
- /**
112
- * @link EchoDatabase.flush
113
- */
114
- static flush = (opts?: FlushOptions) =>
115
- DatabaseService.pipe(Effect.flatMap(({ db }) => promiseWithCauseCapture(() => db.flush(opts))));
116
-
117
- /**
118
- * @link EchoDatabase.getObjectById
119
- */
120
- static getObjectById = <T extends Obj.Any | Relation.Any>(
121
- id: string,
122
- ): Effect.Effect<Live<T> | undefined, never, DatabaseService> => {
123
- return DatabaseService.pipe(Effect.map(({ db }) => db.getObjectById(id)));
124
- };
125
-
126
- /**
127
- * Creates a `QueryResult` object that can be subscribed to.
128
- */
129
- static query: {
130
- <Q extends Query.Any>(query: Q): Effect.Effect<QueryResult<Live<Query.Type<Q>>>, never, DatabaseService>;
131
- <F extends Filter.Any>(filter: F): Effect.Effect<QueryResult<Live<Filter.Type<F>>>, never, DatabaseService>;
132
- } = (queryOrFilter: Query.Any | Filter.Any) =>
133
- DatabaseService.pipe(
134
- Effect.map(({ db }) => db.query(queryOrFilter as any)),
135
- Effect.withSpan('DatabaseService.query'),
136
- );
137
-
138
- /**
139
- * Executes the query once and returns the results.
140
- */
141
- static runQuery: {
142
- <Q extends Query.Any>(query: Q): Effect.Effect<OneShotQueryResult<Live<Query.Type<Q>>>, never, DatabaseService>;
143
- <F extends Filter.Any>(filter: F): Effect.Effect<OneShotQueryResult<Live<Filter.Type<F>>>, never, DatabaseService>;
144
- } = (queryOrFilter: Query.Any | Filter.Any) =>
145
- DatabaseService.query(queryOrFilter as any).pipe(
146
- Effect.flatMap((queryResult) => promiseWithCauseCapture(() => queryResult.run())),
147
- );
148
-
149
- static schemaQuery = <Q extends SchemaRegistryQuery>(
150
- query: Q,
151
- ): Effect.Effect<SchemaRegistryPreparedQuery<EchoSchema>, never, DatabaseService> =>
152
- DatabaseService.pipe(
153
- Effect.map(({ db }) => db.schemaRegistry.query(query)),
154
- Effect.withSpan('DatabaseService.schemaQuery'),
155
- );
156
-
157
- static runSchemaQuery = <Q extends SchemaRegistryQuery>(
158
- query: Q,
159
- ): Effect.Effect<EchoSchema[], never, DatabaseService> =>
160
- DatabaseService.schemaQuery(query).pipe(
161
- Effect.flatMap((queryResult) => promiseWithCauseCapture(() => queryResult.run())),
162
- );
163
- }
164
-
165
- // TODO(burdon): Move to echo/errors.
166
- class ObjectNotFoundError extends BaseError.extend('OBJECT_NOT_FOUND') {
167
- constructor(context?: Record<string, unknown>) {
168
- super('Object not found', { context });
169
- }
170
- }
@@ -1,114 +0,0 @@
1
- //
2
- // Copyright 2025 DXOS.org
3
- //
4
-
5
- import { Context, Effect, Layer, Schema } from 'effect';
6
-
7
- import { todo } from '@dxos/debug';
8
-
9
- import { FunctionError, FunctionNotFoundError } from '../errors';
10
- import type { FunctionContext, FunctionDefinition } from '../handler';
11
-
12
- import type { Services } from './service-container';
13
-
14
- export class LocalFunctionExecutionService extends Context.Tag('@dxos/functions/LocalFunctionExecutionService')<
15
- LocalFunctionExecutionService,
16
- {
17
- // TODO(dmaretskyi): This should take function id instead of the definition object.
18
- // TODO(dmaretskyi): Services should be satisfied from environment rather then bubbled up.
19
- invokeFunction(functionDef: FunctionDefinition<any, any>, input: unknown): Effect.Effect<unknown, never, Services>;
20
- }
21
- >() {
22
- /**
23
- * @deprecated Use layerLive instead.
24
- */
25
- static layer = Layer.succeed(LocalFunctionExecutionService, {
26
- invokeFunction: (functionDef, input) => invokeFunction(functionDef, input),
27
- });
28
-
29
- static layerLive = Layer.effect(
30
- LocalFunctionExecutionService,
31
- Effect.gen(function* () {
32
- const resolver = yield* FunctionImplementationResolver;
33
- return {
34
- invokeFunction: Effect.fn('invokeFunction')(function* (functionDef, input) {
35
- // TODO(dmaretskyi): Better error types
36
- const resolved = yield* resolver.resolveFunctionImplementation(functionDef).pipe(Effect.orDie);
37
- return yield* invokeFunction(resolved, input);
38
- }),
39
- };
40
- }),
41
- );
42
-
43
- static invokeFunction: <F extends FunctionDefinition.Any>(
44
- functionDef: F,
45
- input: FunctionDefinition.Input<F>,
46
- ) => Effect.Effect<FunctionDefinition.Output<F>, never, Services | LocalFunctionExecutionService> =
47
- Effect.serviceFunctionEffect(LocalFunctionExecutionService, (_) => _.invokeFunction as any);
48
- }
49
-
50
- const invokeFunction = (
51
- functionDef: FunctionDefinition<any, any>,
52
- input: any,
53
- ): Effect.Effect<unknown, never, Services> =>
54
- Effect.gen(function* () {
55
- // Assert input matches schema
56
- const assertInput = functionDef.inputSchema.pipe(Schema.asserts);
57
- (assertInput as any)(input);
58
-
59
- const context: FunctionContext = {
60
- space: undefined,
61
- getService: () => todo(),
62
- getSpace: async (_spaceId: any) => {
63
- throw new Error('Not available. Use the database service instead.');
64
- },
65
- };
66
-
67
- // TODO(dmaretskyi): This should be delegated to a function invoker service.
68
- const data = yield* Effect.gen(function* () {
69
- const result = functionDef.handler({ context, data: input });
70
- if (Effect.isEffect(result)) {
71
- return yield* (result as Effect.Effect<unknown, unknown, Services>).pipe(Effect.orDie);
72
- } else if (
73
- typeof result === 'object' &&
74
- result !== null &&
75
- 'then' in result &&
76
- typeof result.then === 'function'
77
- ) {
78
- return yield* Effect.promise(() => result);
79
- } else {
80
- return result;
81
- }
82
- }).pipe(
83
- Effect.orDie,
84
- Effect.catchAllDefect((defect) =>
85
- Effect.die(new FunctionError('Error running function', { context: { name: functionDef.name }, cause: defect })),
86
- ),
87
- );
88
-
89
- // Assert output matches schema
90
- const assertOutput = functionDef.outputSchema?.pipe(Schema.asserts);
91
- (assertOutput as any)(data);
92
-
93
- return data;
94
- }).pipe(Effect.withSpan('invokeFunction', { attributes: { name: functionDef.name } }));
95
-
96
- export class FunctionImplementationResolver extends Context.Tag('@dxos/functions/FunctionImplementationResolver')<
97
- FunctionImplementationResolver,
98
- {
99
- resolveFunctionImplementation(
100
- functionDef: FunctionDefinition<any, any>,
101
- ): Effect.Effect<FunctionDefinition<any, any>, FunctionNotFoundError>;
102
- }
103
- >() {
104
- static layerTest = ({ functions }: { functions: FunctionDefinition<any, any>[] }) =>
105
- Layer.succeed(FunctionImplementationResolver, {
106
- resolveFunctionImplementation: (functionDef) => {
107
- const resolved = functions.find((f) => f.name === functionDef.name);
108
- if (!resolved) {
109
- return Effect.fail(new FunctionNotFoundError(functionDef.name));
110
- }
111
- return Effect.succeed(resolved);
112
- },
113
- });
114
- }
@@ -1,46 +0,0 @@
1
- //
2
- // Copyright 2025 DXOS.org
3
- //
4
-
5
- import { Context, Layer } from 'effect';
6
-
7
- import type { SpaceId } from '@dxos/keys';
8
-
9
- import { getInvocationUrl } from '../url';
10
-
11
- /**
12
- * Allows calling into other functions.
13
- */
14
- export class RemoteFunctionExecutionService extends Context.Tag('@dxos/functions/RemoteFunctionExecutionService')<
15
- RemoteFunctionExecutionService,
16
- {
17
- callFunction(deployedFunctionId: string, input: any, spaceId?: SpaceId): Promise<any>;
18
- }
19
- >() {
20
- static fromClient(baseUrl: string, spaceId: SpaceId): Context.Tag.Service<RemoteFunctionExecutionService> {
21
- return {
22
- callFunction: async (deployedFunctionId: string, input: any) => {
23
- const url = getInvocationUrl(deployedFunctionId, baseUrl, { spaceId });
24
- const result = await fetch(url, {
25
- method: 'POST',
26
- headers: { 'Content-Type': 'application/json' },
27
- body: JSON.stringify(input),
28
- });
29
- if (result.status >= 300 || result.status < 200) {
30
- throw new Error('Failed to invoke function', { cause: new Error(`HTTP error: ${await result.text()}`) });
31
- }
32
- return await result.json();
33
- },
34
- };
35
- }
36
-
37
- static mock = (): Context.Tag.Service<RemoteFunctionExecutionService> => {
38
- return {
39
- callFunction: async (deployedFunctionId: string, input: any) => {
40
- return input;
41
- },
42
- };
43
- };
44
-
45
- static mockLayer = Layer.succeed(RemoteFunctionExecutionService, RemoteFunctionExecutionService.mock());
46
- }
@@ -1,114 +0,0 @@
1
- //
2
- // Copyright 2025 DXOS.org
3
- //
4
-
5
- import { type Context, Layer } from 'effect';
6
-
7
- import { AiService } from '@dxos/ai';
8
- import { entries } from '@dxos/util';
9
-
10
- import { ConfiguredCredentialsService, CredentialsService } from './credentials';
11
- import { DatabaseService } from './database';
12
- import { ComputeEventLogger } from './event-logger';
13
- import { QueueService } from './queues';
14
- import { RemoteFunctionExecutionService } from './remote-function-execution-service';
15
- import { TracingService } from './tracing';
16
-
17
- // TODO(dmaretskyi): Refactor this module to only rely on tags and not the human-assigned names.
18
-
19
- /**
20
- * List of all services.
21
- */
22
- const SERVICES = {
23
- ai: AiService.AiService,
24
- credentials: CredentialsService,
25
- database: DatabaseService,
26
- eventLogger: ComputeEventLogger,
27
- functionCallService: RemoteFunctionExecutionService,
28
- queues: QueueService,
29
- tracing: TracingService,
30
- } as const satisfies Record<string, Context.TagClass<any, string, any>>;
31
-
32
- /**
33
- * Mapping of service names to their tags.
34
- */
35
- export type ServiceTagRecord = {
36
- [K in keyof typeof SERVICES]: (typeof SERVICES)[K] extends { new (_: never): infer T } ? T : never;
37
- };
38
-
39
- /**
40
- * Mapping of service names to their runtime types.
41
- */
42
- export type ServiceRecord = {
43
- [K in keyof ServiceTagRecord]: Context.Tag.Service<ServiceTagRecord[K]>;
44
- };
45
-
46
- /**
47
- * Union of all services tags.
48
- */
49
- export type Services = ServiceTagRecord[keyof ServiceTagRecord];
50
-
51
- const SERVICE_MAPPING: Record<string, keyof ServiceRecord> = Object.fromEntries(
52
- entries(SERVICES).map(([name, tag]) => [tag.key, name]),
53
- );
54
-
55
- export const SERVICE_TAGS: Context.Tag<any, any>[] = Object.values(SERVICES);
56
-
57
- const DEFAULT_SERVICES: Partial<ServiceRecord> = {
58
- tracing: TracingService.noop,
59
- };
60
-
61
- /**
62
- * @deprecated
63
- */
64
- export class ServiceContainer {
65
- private _services: Partial<ServiceRecord> = { ...DEFAULT_SERVICES };
66
-
67
- /**
68
- * Set services.
69
- * @param services - Services to set.
70
- * @returns The container instance.
71
- */
72
- setServices(services: Partial<ServiceRecord>): this {
73
- this._services = { ...this._services, ...services };
74
- return this;
75
- }
76
-
77
- getService<Id, T>(tag: Context.Tag<Id, T>): T {
78
- const serviceKey = SERVICE_MAPPING[tag.key];
79
- const service = serviceKey != null ? this._services[serviceKey] : undefined;
80
- if (!service) {
81
- throw new Error(`Service not available: ${tag.key}`);
82
- }
83
-
84
- return service as T;
85
- }
86
-
87
- clone(): ServiceContainer {
88
- return new ServiceContainer().setServices({ ...this._services });
89
- }
90
-
91
- // TODO(dmaretskyi): `getService` is designed to error at runtime if the service is not available, but Layer forces us to provide all services and makes stubs for the ones that are not available.
92
- createLayer(): Layer.Layer<Services> {
93
- const ai =
94
- this._services.ai != null ? Layer.succeed(AiService.AiService, this._services.ai) : AiService.notAvailable;
95
- const credentials = Layer.succeed(
96
- CredentialsService,
97
- this._services.credentials ?? new ConfiguredCredentialsService(),
98
- );
99
- const database =
100
- this._services.database != null
101
- ? Layer.succeed(DatabaseService, this._services.database)
102
- : DatabaseService.notAvailable;
103
- const queues =
104
- this._services.queues != null ? Layer.succeed(QueueService, this._services.queues) : QueueService.notAvailable;
105
- const tracing = Layer.succeed(TracingService, this._services.tracing ?? TracingService.noop);
106
- const eventLogger = Layer.succeed(ComputeEventLogger, this._services.eventLogger ?? ComputeEventLogger.noop);
107
- const functionCallService = Layer.succeed(
108
- RemoteFunctionExecutionService,
109
- this._services.functionCallService ?? RemoteFunctionExecutionService.mock(),
110
- );
111
-
112
- return Layer.mergeAll(ai, credentials, database, queues, tracing, eventLogger, functionCallService);
113
- }
114
- }
@@ -1,42 +0,0 @@
1
- //
2
- // Copyright 2025 DXOS.org
3
- //
4
-
5
- import { describe, it } from '@effect/vitest';
6
- import { Context, Effect, Layer, Option } from 'effect';
7
-
8
- import { ServiceRegistry } from './service-registry';
9
-
10
- class MyTag extends Context.Tag('MyTag')<MyTag, { value: string }>() {}
11
-
12
- const mockRegistry = Layer.succeed(ServiceRegistry, {
13
- resolve: (tag) => ((tag as any) === MyTag ? Option.some({ value: 'test' } as any) : Option.none()),
14
- });
15
-
16
- describe('ServiceRegistry', () => {
17
- it.effect(
18
- 'provide',
19
- Effect.fn(function* ({ expect }) {
20
- const body = Effect.gen(function* () {
21
- const { value } = yield* MyTag;
22
- expect(value).toEqual('test');
23
- });
24
-
25
- const eff = body.pipe(ServiceRegistry.provide(MyTag));
26
- yield* eff;
27
- }, Effect.provide(mockRegistry)),
28
- );
29
-
30
- it.effect(
31
- 'provide or die',
32
- Effect.fn(function* ({ expect }) {
33
- const body = Effect.gen(function* () {
34
- const { value } = yield* MyTag;
35
- expect(value).toEqual('test');
36
- });
37
-
38
- const eff = body.pipe(ServiceRegistry.provideOrDie(MyTag));
39
- yield* eff;
40
- }, Effect.provide(mockRegistry)),
41
- );
42
- });
@@ -1,59 +0,0 @@
1
- //
2
- // Copyright 2025 DXOS.org
3
- //
4
-
5
- import { Context, Effect, type Option, flow } from 'effect';
6
-
7
- import { ServiceNotAvailableError } from '../errors';
8
-
9
- export namespace ServiceRegistry {
10
- export interface Service {
11
- resolve: <T extends Context.Tag<any, any>>(tag: T) => Option.Option<Context.Tag.Service<T>>;
12
- }
13
- }
14
-
15
- export class ServiceRegistry extends Context.Tag('@dxos/functions/ServiceRegistry')<
16
- ServiceRegistry,
17
- ServiceRegistry.Service
18
- >() {
19
- /**
20
- * Resolves the service from the registry.
21
- * @param tag Service tag to resolve.
22
- * @throws {@link ServiceNotAvailableError} if the service is not found.
23
- * @returns Effect that resolve to the service.
24
- */
25
- static resolve: <T extends Context.Tag<any, any>>(
26
- tag: T,
27
- ) => Effect.Effect<T, ServiceNotAvailableError, ServiceRegistry> = (tag) =>
28
- ServiceRegistry.pipe(
29
- Effect.flatMap((_) => _.resolve(tag)),
30
- Effect.mapError(() => new ServiceNotAvailableError(tag.key)),
31
- );
32
-
33
- static provide: {
34
- <Tags extends [Context.Tag<any, any>, ...Context.Tag<any, any>[]]>(
35
- ...tags: Tags
36
- ): <A, E, R>(
37
- effect: Effect.Effect<A, E, R>,
38
- ) => Effect.Effect<
39
- A,
40
- E | ServiceNotAvailableError,
41
- Exclude<R, { [K in keyof Tags]: Context.Tag.Identifier<Tags[K]> }[number]> | ServiceRegistry
42
- >;
43
- } = (...tags) => (flow as any)(...tags.map((tag) => Effect.provideServiceEffect(tag, ServiceRegistry.resolve(tag))));
44
-
45
- static provideOrDie: {
46
- <Tags extends [Context.Tag<any, any>, ...Context.Tag<any, any>[]]>(
47
- ...tags: Tags
48
- ): <A, E, R>(
49
- effect: Effect.Effect<A, E, R>,
50
- ) => Effect.Effect<
51
- A,
52
- E,
53
- Exclude<R, { [K in keyof Tags]: Context.Tag.Identifier<Tags[K]> }[number]> | ServiceRegistry
54
- >;
55
- } = (...tags) =>
56
- (flow as any)(
57
- ...tags.map((tag) => Effect.provideServiceEffect(tag, ServiceRegistry.resolve(tag).pipe(Effect.orDie))),
58
- );
59
- }
@@ -1,6 +0,0 @@
1
- //
2
- // Copyright 2025 DXOS.org
3
- //
4
-
5
- export * from './services';
6
- export * from './layer';
@@ -1,111 +0,0 @@
1
- //
2
- // Copyright 2025 DXOS.org
3
- //
4
-
5
- import type { Schema } from 'effect';
6
- import { Context, Effect, Layer } from 'effect';
7
-
8
- import type { EchoDatabaseImpl, QueueFactory } from '@dxos/echo-db';
9
- import { EchoTestBuilder } from '@dxos/echo-db/testing';
10
- import type { EchoHostIndexingConfig } from '@dxos/echo-pipeline';
11
- import { accuireReleaseResource } from '@dxos/effect';
12
- import { PublicKey } from '@dxos/keys';
13
- import type { LevelDB } from '@dxos/kv-store';
14
- import { createTestLevel } from '@dxos/kv-store/testing';
15
- import { log } from '@dxos/log';
16
-
17
- import { DatabaseService, QueueService } from '../services';
18
-
19
- const testBuilder = accuireReleaseResource(() => new EchoTestBuilder());
20
-
21
- export const testStoragePath = ({ name = PublicKey.random().toHex() }: { name?: string }) => {
22
- return `/tmp/dxos-${name}`;
23
- };
24
-
25
- export type TestDatabaseOptions = {
26
- indexing?: Partial<EchoHostIndexingConfig>;
27
- types?: Schema.Schema.AnyNoContext[];
28
- storagePath?: string;
29
- onInit?: () => Effect.Effect<void, never, DatabaseService | QueueService>;
30
- };
31
-
32
- export const TestDatabaseLayer = ({ indexing, types, storagePath, onInit }: TestDatabaseOptions = {}) =>
33
- Layer.scopedContext(
34
- Effect.gen(function* () {
35
- const builder = yield* testBuilder;
36
-
37
- let kv: LevelDB | undefined;
38
- if (storagePath) {
39
- kv = createTestLevel(storagePath);
40
- yield* Effect.promise(() => kv!.open());
41
- // const keyCount = yield* Effect.promise(async () => (await kv!.iterator({ values: false }).all()).length);
42
- // log.info('opened test db', { storagePath, keyCount });
43
- }
44
- const peer = yield* Effect.promise(() => builder.createPeer({ indexing, types, kv }));
45
-
46
- let db: EchoDatabaseImpl | undefined;
47
- let queues: QueueFactory | undefined;
48
-
49
- if (storagePath) {
50
- const testMetadata = yield* Effect.promise(async () => {
51
- try {
52
- return await kv!.get('test-metadata', { valueEncoding: 'json' });
53
- } catch (e) {
54
- if ((e as any).code === 'LEVEL_NOT_FOUND') {
55
- return undefined;
56
- }
57
- throw e;
58
- }
59
- });
60
- log('starting persistant test db', { storagePath, testMetadata });
61
- if (!testMetadata) {
62
- const key = PublicKey.random();
63
- db = yield* Effect.promise(() => peer.createDatabase(key));
64
- queues = peer.client.constructQueueFactory(db.spaceId);
65
-
66
- yield* Effect.promise(() =>
67
- kv!.put('test-metadata', { key: key.toHex(), rootUrl: db!.rootUrl }, { valueEncoding: 'json' }),
68
- );
69
-
70
- if (onInit) {
71
- yield* onInit().pipe(
72
- Effect.provideService(DatabaseService, DatabaseService.make(db)),
73
- Effect.provideService(QueueService, QueueService.make(queues, undefined)),
74
- );
75
- }
76
- } else {
77
- const key = PublicKey.from((testMetadata as any).key);
78
- const rootUrl = (testMetadata as any).rootUrl;
79
- db = yield* Effect.promise(() => peer.openDatabase(key, rootUrl));
80
- queues = peer.client.constructQueueFactory(db.spaceId);
81
- }
82
- } else {
83
- db = yield* Effect.promise(() => peer.createDatabase());
84
- queues = peer.client.constructQueueFactory(db.spaceId);
85
- if (onInit) {
86
- yield* onInit().pipe(
87
- Effect.provideService(DatabaseService, DatabaseService.make(db)),
88
- Effect.provideService(QueueService, QueueService.make(queues, undefined)),
89
- );
90
- }
91
- }
92
-
93
- yield* Effect.addFinalizer(() =>
94
- Effect.promise(async () => {
95
- if (kv) {
96
- // {
97
- // const keyCount = (await kv.iterator({ values: false }).all()).length;
98
- // log.info('closing persistant test db', { storagePath, keyCount });
99
- // }
100
-
101
- await kv.close();
102
- }
103
- }),
104
- );
105
-
106
- return Context.mergeAll(
107
- Context.make(DatabaseService, DatabaseService.make(db)),
108
- Context.make(QueueService, QueueService.make(queues, undefined)),
109
- );
110
- }),
111
- );
@@ -1,16 +0,0 @@
1
- //
2
- // Copyright 2025 DXOS.org
3
- //
4
-
5
- import { type Context, Effect } from 'effect';
6
-
7
- import { LogLevel } from '@dxos/log';
8
-
9
- import { type ComputeEventLogger, createEventLogger } from '../services';
10
-
11
- export const noopLogger: Context.Tag.Service<ComputeEventLogger> = {
12
- log: () => Effect.succeed(undefined),
13
- nodeId: undefined,
14
- };
15
-
16
- export const consoleLogger: Context.Tag.Service<ComputeEventLogger> = createEventLogger(LogLevel.INFO);