@helmr/sdk 0.1.0-preview.g52eb0eef.b35190749915

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 (47) hide show
  1. package/LICENSE +190 -0
  2. package/README.md +65 -0
  3. package/dist/actor.d.ts +3 -0
  4. package/dist/client-actor.d.ts +32 -0
  5. package/dist/client-deployment.d.ts +30 -0
  6. package/dist/client-sandbox.d.ts +26 -0
  7. package/dist/client-schedule.d.ts +44 -0
  8. package/dist/client-secret.d.ts +51 -0
  9. package/dist/client-session.d.ts +38 -0
  10. package/dist/client-workspace.d.ts +36 -0
  11. package/dist/client.d.ts +153 -0
  12. package/dist/config.d.ts +11 -0
  13. package/dist/contract.d.ts +341 -0
  14. package/dist/definitions.d.ts +42 -0
  15. package/dist/fuzzy.d.ts +1 -0
  16. package/dist/fuzzy.js +29 -0
  17. package/dist/image.d.ts +63 -0
  18. package/dist/index.d.ts +29 -0
  19. package/dist/index.js +3029 -0
  20. package/dist/internal/abort.d.ts +1 -0
  21. package/dist/internal/definition-query.d.ts +10 -0
  22. package/dist/internal/id.d.ts +1 -0
  23. package/dist/internal/jsoncanon.d.ts +5 -0
  24. package/dist/internal/origin.d.ts +1 -0
  25. package/dist/internal/program.d.ts +10 -0
  26. package/dist/internal/run-failure.d.ts +2 -0
  27. package/dist/internal/run-handle.d.ts +3 -0
  28. package/dist/internal/runtime.d.ts +43 -0
  29. package/dist/internal/session.d.ts +5 -0
  30. package/dist/internal/strings.d.ts +1 -0
  31. package/dist/internal/timestamp.d.ts +1 -0
  32. package/dist/internal/utf8.d.ts +3 -0
  33. package/dist/internal.d.ts +13 -0
  34. package/dist/internal.js +994 -0
  35. package/dist/logger.d.ts +9 -0
  36. package/dist/metadata.d.ts +6 -0
  37. package/dist/request.d.ts +3 -0
  38. package/dist/schedules.d.ts +33 -0
  39. package/dist/schema/payload.d.ts +39 -0
  40. package/dist/schema/task.d.ts +3 -0
  41. package/dist/secret.d.ts +1 -0
  42. package/dist/session.d.ts +5 -0
  43. package/dist/task.d.ts +2 -0
  44. package/dist/timers.d.ts +6 -0
  45. package/dist/tokens.d.ts +77 -0
  46. package/dist/workspace.d.ts +142 -0
  47. package/package.json +49 -0
@@ -0,0 +1 @@
1
+ export declare function abortableDelay(milliseconds: number, signal?: AbortSignal): Promise<void>;
@@ -0,0 +1,10 @@
1
+ interface DefinitionQuery {
2
+ readonly deploymentId?: string;
3
+ }
4
+ interface DefinitionListQuery extends DefinitionQuery {
5
+ readonly cursor?: string;
6
+ readonly limit?: number;
7
+ }
8
+ export declare function definitionItemQuery(queryInput: DefinitionQuery, label: string): string;
9
+ export declare function definitionListQuery(queryInput: DefinitionListQuery, label: string): string;
10
+ export {};
@@ -0,0 +1 @@
1
+ export declare function resourceID(value: unknown, label: string): string;
@@ -0,0 +1,5 @@
1
+ export type JsonValue = null | boolean | number | string | readonly JsonValue[] | JsonObject;
2
+ export interface JsonObject {
3
+ readonly [key: string]: JsonValue;
4
+ }
5
+ export declare function canonicalizeJsonValue(value: JsonValue): Uint8Array;
@@ -0,0 +1 @@
1
+ export declare function canonicalSecretOrigin(value: string): string;
@@ -0,0 +1,10 @@
1
+ export type RuntimeArchitecture = "x86_64";
2
+ export type ProgramDeclaration = Readonly<{
3
+ kind: "task";
4
+ declaredId: string;
5
+ slots: readonly ["handler"] | readonly ["handler", "payloadSchema"];
6
+ }> | Readonly<{
7
+ kind: "actor";
8
+ declaredId: string;
9
+ slots: readonly ["handler"];
10
+ }>;
@@ -0,0 +1,2 @@
1
+ import type { RunFailure } from "../contract.js";
2
+ export declare function runFailureError(failure: RunFailure): Error;
@@ -0,0 +1,3 @@
1
+ import type { JsonValue, RunHandle } from "../contract.js";
2
+ export declare function createRunHandle<TOutput extends JsonValue = JsonValue>(id: unknown): RunHandle<TOutput>;
3
+ export declare function runHandleID(value: string | RunHandle): string;
@@ -0,0 +1,43 @@
1
+ import type { SessionCloseRequest, SessionCloseReceipt, SessionInputRecord, SessionInputSendRequest, SessionOutputQuery, SessionOutputRecord, ActorStartOptions, Session, Duration, JsonValue, Metadata, RunHandle, TaskCallOptions, TaskResult, TaskStartOptions } from "../contract.js";
2
+ import type { LogAttributes, RunLogLevel } from "../logger.js";
3
+ import type { TokenCreateRequest, TokenCreateResult, TokenWaitOptions } from "../tokens.js";
4
+ import type { WorkspaceCreateRequest, WorkspaceDeleteRequest, WorkspaceDeleteReceipt, WorkspaceExecRequest, WorkspaceExecResult, Workspace } from "../workspace.js";
5
+ export interface RuntimeOperations {
6
+ readonly taskStart: (target: Readonly<{
7
+ declaredId: string;
8
+ payloadPresent: boolean;
9
+ }>, payload: JsonValue | undefined, options: TaskStartOptions) => Promise<RunHandle>;
10
+ readonly taskCall: (target: Readonly<{
11
+ declaredId: string;
12
+ payloadPresent: boolean;
13
+ }>, payload: JsonValue | undefined, options: TaskCallOptions) => Promise<TaskResult<JsonValue>>;
14
+ readonly waitFor: (duration: Duration) => Promise<void>;
15
+ readonly waitUntil: (date: Date) => Promise<void>;
16
+ readonly actorInputSend: (sessionId: string, input: JsonValue, request?: SessionInputSendRequest, signal?: AbortSignal) => Promise<SessionInputRecord>;
17
+ readonly actorStart: (declaredId: string, options: ActorStartOptions) => Promise<Readonly<{
18
+ sessionId: string;
19
+ runId: string;
20
+ }>>;
21
+ readonly sessionRetrieve: (sessionId: string, signal?: AbortSignal) => Promise<Session>;
22
+ readonly sessionClose: (sessionId: string, request?: SessionCloseRequest, signal?: AbortSignal) => Promise<SessionCloseReceipt>;
23
+ readonly sessionOutputPage: (sessionId: string, query?: SessionOutputQuery, signal?: AbortSignal) => Promise<Readonly<{
24
+ records: readonly SessionOutputRecord[];
25
+ nextAfter: number;
26
+ hasMore: boolean;
27
+ }>>;
28
+ readonly workspaceCreate: (declaredId: string, request?: WorkspaceCreateRequest, signal?: AbortSignal) => Promise<Readonly<{
29
+ workspaceId: string;
30
+ }>>;
31
+ readonly workspaceRetrieve: (workspaceId: string, signal?: AbortSignal) => Promise<Workspace>;
32
+ readonly workspaceExec: (workspaceId: string, request: WorkspaceExecRequest, signal?: AbortSignal) => Promise<WorkspaceExecResult>;
33
+ readonly workspaceDelete: (workspaceId: string, request?: WorkspaceDeleteRequest, signal?: AbortSignal) => Promise<WorkspaceDeleteReceipt>;
34
+ readonly tokenCreate: (request: TokenCreateRequest) => Promise<TokenCreateResult>;
35
+ readonly tokenWait: (tokenId: string, options: TokenWaitOptions) => Promise<JsonValue>;
36
+ readonly metadataSet: (key: string, value: JsonValue) => Promise<void>;
37
+ readonly metadataPatch: (values: Metadata) => Promise<void>;
38
+ readonly metadataIncrement: (key: string, amount: number) => Promise<void>;
39
+ readonly structuredLog: (level: RunLogLevel, message: string, attributes: LogAttributes) => Promise<void>;
40
+ }
41
+ export declare function installRuntimeOperations(operations: RuntimeOperations): () => void;
42
+ export declare function currentRuntimeOperations(): RuntimeOperations;
43
+ export declare function runtimeOperationsInstalled(): boolean;
@@ -0,0 +1,5 @@
1
+ import type { Session, SessionInputRecord, SessionOutputRecord, SessionStatus } from "../contract.js";
2
+ export declare function parseSession(value: unknown): Session;
3
+ export declare function parseSessionInputRecord(value: unknown): SessionInputRecord;
4
+ export declare function parseSessionOutputRecord(value: unknown): SessionOutputRecord;
5
+ export declare function sessionStatus(value: unknown, label?: string): SessionStatus;
@@ -0,0 +1 @@
1
+ export declare function trimGoSpace(value: string): string;
@@ -0,0 +1 @@
1
+ export declare function timestampString(value: unknown, label: string): string;
@@ -0,0 +1,3 @@
1
+ export declare function compareUTF8(left: string, right: string): number;
2
+ export declare function hasOnlyUnicodeScalarValues(value: string): boolean;
3
+ export declare function assertUnicodeString(value: string): void;
@@ -0,0 +1,13 @@
1
+ export { inspectConfig, matchesIgnorePattern, type HelmrConfig, } from "./config.js";
2
+ export { inspectDefinition, isQueue, type InternalActorDefinition, type InternalDefinition, type InternalTaskDefinition, } from "./definitions.js";
3
+ export { inspectImage, type InternalImage, type InternalImageStep, } from "./image.js";
4
+ export { inspectSandboxDefinition, inspectWorkspaceAddress, workspaceRefID, brandWorkspaceAddress, createWorkspaceRef, encodeWorkspaceSecrets, parseWorkspaceDeleteReceipt, parseWorkspaceExecResult, parseWorkspace, type EncodedWorkspaceSecret, type WorkspaceResources, type InternalSandboxDefinition, } from "./workspace.js";
5
+ export { canonicalizeJsonValue, type JsonObject, type JsonValue, } from "./internal/jsoncanon.js";
6
+ export { type ProgramDeclaration, type RuntimeArchitecture, } from "./internal/program.js";
7
+ export { installRuntimeOperations, type RuntimeOperations, } from "./internal/runtime.js";
8
+ export { resourceID } from "./internal/id.js";
9
+ export { createRunHandle, runHandleID } from "./internal/run-handle.js";
10
+ export { parseSession, parseSessionInputRecord, parseSessionOutputRecord, } from "./internal/session.js";
11
+ export { trimGoSpace } from "./internal/strings.js";
12
+ export { timestampString } from "./internal/timestamp.js";
13
+ export { validateQueueName } from "./schema/task.js";