@solidactions/sdk 0.1.0 → 0.2.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 (115) hide show
  1. package/README.md +28 -4
  2. package/dist/src/adminserver.d.ts +0 -2
  3. package/dist/src/adminserver.d.ts.map +1 -1
  4. package/dist/src/adminserver.js +17 -7
  5. package/dist/src/adminserver.js.map +1 -1
  6. package/dist/src/authdecorators.js +1 -2
  7. package/dist/src/authdecorators.js.map +1 -1
  8. package/dist/src/cli/cli.js +0 -0
  9. package/dist/src/conductor/conductor.d.ts +0 -1
  10. package/dist/src/conductor/conductor.d.ts.map +1 -1
  11. package/dist/src/conductor/conductor.js +17 -7
  12. package/dist/src/conductor/conductor.js.map +1 -1
  13. package/dist/src/config.js +11 -11
  14. package/dist/src/config.js.map +1 -1
  15. package/dist/src/context.d.ts +0 -2
  16. package/dist/src/context.d.ts.map +1 -1
  17. package/dist/src/context.js +8 -9
  18. package/dist/src/context.js.map +1 -1
  19. package/dist/src/database_utils.js +3 -4
  20. package/dist/src/database_utils.js.map +1 -1
  21. package/dist/src/debugpoint.js +5 -5
  22. package/dist/src/debugpoint.js.map +1 -1
  23. package/dist/src/decorators.d.ts.map +1 -1
  24. package/dist/src/decorators.js +35 -35
  25. package/dist/src/decorators.js.map +1 -1
  26. package/dist/src/error.d.ts +2 -2
  27. package/dist/src/error.d.ts.map +1 -1
  28. package/dist/src/error.js +3 -3
  29. package/dist/src/error.js.map +1 -1
  30. package/dist/src/http_client.d.ts +7 -1
  31. package/dist/src/http_client.d.ts.map +1 -1
  32. package/dist/src/http_client.js +17 -6
  33. package/dist/src/http_client.js.map +1 -1
  34. package/dist/src/http_system_database.d.ts +1 -0
  35. package/dist/src/http_system_database.d.ts.map +1 -1
  36. package/dist/src/http_system_database.js +11 -1
  37. package/dist/src/http_system_database.js.map +1 -1
  38. package/dist/src/index.js +17 -7
  39. package/dist/src/index.js.map +1 -1
  40. package/dist/src/serialization.d.ts.map +1 -1
  41. package/dist/src/serialization.js +7 -7
  42. package/dist/src/serialization.js.map +1 -1
  43. package/dist/src/solidactions-executor.js +17 -7
  44. package/dist/src/solidactions-executor.js.map +1 -1
  45. package/dist/src/solidactions.d.ts +23 -3
  46. package/dist/src/solidactions.d.ts.map +1 -1
  47. package/dist/src/solidactions.js +30 -4
  48. package/dist/src/solidactions.js.map +1 -1
  49. package/dist/src/system_database.d.ts +1 -0
  50. package/dist/src/system_database.d.ts.map +1 -1
  51. package/dist/src/system_database.js.map +1 -1
  52. package/dist/src/telemetry/collector.d.ts.map +1 -1
  53. package/dist/src/telemetry/logs.d.ts.map +1 -1
  54. package/dist/src/telemetry/traces.js +5 -5
  55. package/dist/src/telemetry/traces.js.map +1 -1
  56. package/dist/src/testing/index.d.ts +13 -0
  57. package/dist/src/testing/index.d.ts.map +1 -0
  58. package/dist/src/testing/index.js +19 -0
  59. package/dist/src/testing/index.js.map +1 -0
  60. package/dist/src/testing/mock_server.d.ts +134 -0
  61. package/dist/src/testing/mock_server.d.ts.map +1 -0
  62. package/dist/src/testing/mock_server.js +613 -0
  63. package/dist/src/testing/mock_server.js.map +1 -0
  64. package/dist/src/utils.d.ts +0 -1
  65. package/dist/src/utils.d.ts.map +1 -1
  66. package/dist/src/utils.js +8 -8
  67. package/dist/src/utils.js.map +1 -1
  68. package/dist/src/workflow.d.ts +1 -1
  69. package/dist/src/workflow.d.ts.map +1 -1
  70. package/dist/src/workflow.js +2 -2
  71. package/dist/src/workflow.js.map +1 -1
  72. package/dist/src/workflow_management.js +7 -8
  73. package/dist/src/workflow_management.js.map +1 -1
  74. package/dist/tsconfig.tsbuildinfo +1 -1
  75. package/docs/sdk-reference.md +1207 -0
  76. package/package.json +6 -1
  77. package/.claude/settings.local.json +0 -7
  78. package/dist/dbos-config.schema.json +0 -132
  79. package/dist/src/cli/commands.d.ts +0 -3
  80. package/dist/src/cli/commands.d.ts.map +0 -1
  81. package/dist/src/cli/commands.js +0 -46
  82. package/dist/src/cli/commands.js.map +0 -1
  83. package/dist/src/datasource.d.ts +0 -109
  84. package/dist/src/datasource.d.ts.map +0 -1
  85. package/dist/src/datasource.js +0 -204
  86. package/dist/src/datasource.js.map +0 -1
  87. package/dist/src/dbos-executor.d.ts +0 -189
  88. package/dist/src/dbos-executor.d.ts.map +0 -1
  89. package/dist/src/dbos-executor.js +0 -817
  90. package/dist/src/dbos-executor.js.map +0 -1
  91. package/dist/src/dbos.d.ts +0 -519
  92. package/dist/src/dbos.d.ts.map +0 -1
  93. package/dist/src/dbos.js +0 -1282
  94. package/dist/src/dbos.js.map +0 -1
  95. package/dist/src/debouncer.d.ts +0 -33
  96. package/dist/src/debouncer.d.ts.map +0 -1
  97. package/dist/src/debouncer.js +0 -170
  98. package/dist/src/debouncer.js.map +0 -1
  99. package/dist/src/scheduler/crontab.d.ts +0 -14
  100. package/dist/src/scheduler/crontab.d.ts.map +0 -1
  101. package/dist/src/scheduler/crontab.js +0 -308
  102. package/dist/src/scheduler/crontab.js.map +0 -1
  103. package/dist/src/scheduler/scheduler.d.ts +0 -41
  104. package/dist/src/scheduler/scheduler.d.ts.map +0 -1
  105. package/dist/src/scheduler/scheduler.js +0 -165
  106. package/dist/src/scheduler/scheduler.js.map +0 -1
  107. package/dist/src/wfqueue.d.ts +0 -64
  108. package/dist/src/wfqueue.d.ts.map +0 -1
  109. package/dist/src/wfqueue.js +0 -147
  110. package/dist/src/wfqueue.js.map +0 -1
  111. package/docs/api-schema.md +0 -1441
  112. package/docs/migration-guide.md +0 -460
  113. package/docs/phase-14-changes.md +0 -156
  114. package/docs/solidsteps-ai-prompt.md +0 -534
  115. package/solidactions-ai-prompt.md +0 -1504
@@ -0,0 +1,134 @@
1
+ /**
2
+ * Mock HTTP Server for SolidActions SDK Testing & Local Development
3
+ *
4
+ * Provides an in-memory HTTP server that implements the SolidActions API
5
+ * for testing and running workflows locally without a real backend.
6
+ *
7
+ * Usage:
8
+ * import { createMockServer } from '@solidactions/sdk/testing';
9
+ * const server = await createMockServer();
10
+ * // server.baseUrl is now available (e.g., http://127.0.0.1:12345)
11
+ */
12
+ interface MockWorkflow {
13
+ workflowUUID: string;
14
+ status: string;
15
+ workflowName: string;
16
+ workflowClassName: string;
17
+ workflowConfigName: string;
18
+ authenticatedUser: string;
19
+ assumedRole: string;
20
+ authenticatedRoles: string[];
21
+ request: object;
22
+ executorId: string;
23
+ applicationVersion?: string;
24
+ applicationID: string;
25
+ input: string | null;
26
+ output: string | null;
27
+ error: string | null;
28
+ createdAt: number;
29
+ updatedAt: number;
30
+ queueName?: string;
31
+ recoveryAttempts: number;
32
+ timeoutMS?: number;
33
+ deadlineEpochMS?: number;
34
+ deduplicationID?: string;
35
+ priority: number;
36
+ queuePartitionKey?: string;
37
+ forkedFrom?: string;
38
+ }
39
+ interface MockOperation {
40
+ workflowUUID: string;
41
+ functionId?: number;
42
+ functionID?: number;
43
+ functionName: string;
44
+ output: string | null;
45
+ error: string | null;
46
+ childWorkflowId?: string | null;
47
+ childWorkflowID?: string | null;
48
+ startedAtEpochMs?: number;
49
+ startTimeEpochMs?: number;
50
+ completedAtEpochMs?: number;
51
+ endTimeEpochMs?: number;
52
+ checkConflict?: boolean;
53
+ }
54
+ interface MockMessage {
55
+ destinationUUID: string;
56
+ topic: string | null;
57
+ message: string | null;
58
+ consumed: boolean;
59
+ }
60
+ interface MockEvent {
61
+ workflowUUID: string;
62
+ key: string;
63
+ value: string | null;
64
+ }
65
+ interface MockStream {
66
+ workflowUUID: string;
67
+ key: string;
68
+ values: unknown[];
69
+ closed: boolean;
70
+ }
71
+ /**
72
+ * In-memory storage for mock server
73
+ */
74
+ export declare class MockStore {
75
+ workflows: Map<string, MockWorkflow>;
76
+ operations: Map<string, MockOperation[]>;
77
+ messages: MockMessage[];
78
+ events: Map<string, MockEvent>;
79
+ streams: Map<string, MockStream>;
80
+ eventDispatch: Map<string, object>;
81
+ clear(): void;
82
+ }
83
+ /**
84
+ * Mock HTTP Server for testing
85
+ */
86
+ export declare class MockHttpServer {
87
+ private server;
88
+ private port;
89
+ store: MockStore;
90
+ requestLog: Array<{
91
+ method: string;
92
+ path: string;
93
+ body?: unknown;
94
+ }>;
95
+ constructor(port?: number);
96
+ start(): Promise<number>;
97
+ stop(): Promise<void>;
98
+ get baseUrl(): string;
99
+ private handleRequest;
100
+ private readBody;
101
+ private route;
102
+ private createWorkflow;
103
+ private getWorkflow;
104
+ private listWorkflows;
105
+ private recordOutput;
106
+ private recordError;
107
+ private getResult;
108
+ private setWorkflowStatus;
109
+ private cancelWorkflow;
110
+ private resumeWorkflow;
111
+ private checkCancelled;
112
+ private getPendingWorkflows;
113
+ private forkWorkflow;
114
+ private getOperations;
115
+ private getOperation;
116
+ private recordOperation;
117
+ private sendMessage;
118
+ private receiveMessage;
119
+ private setEvent;
120
+ private getEvent;
121
+ private startQueuedWorkflows;
122
+ private getDeduplicatedWorkflow;
123
+ private writeStream;
124
+ private readStream;
125
+ private closeStream;
126
+ private getEventDispatch;
127
+ private upsertEventDispatch;
128
+ }
129
+ /**
130
+ * Helper function to create and start a mock server
131
+ */
132
+ export declare function createMockServer(port?: number): Promise<MockHttpServer>;
133
+ export {};
134
+ //# sourceMappingURL=mock_server.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mock_server.d.ts","sourceRoot":"","sources":["../../../src/testing/mock_server.ts"],"names":[],"mappings":"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"}