@qlever-llc/trellis 0.10.22 → 0.11.0-rc.1

package/esm/contract_support/mod.js

@@ -5,7 +5,7 @@ import { canonicalizeJson, digestJson, isJsonValue, sha256Base64urlSync, } from
 import { schema, unwrapSchema, } from "./runtime.js";
 import { assertDataPointersExistAndAreTokenable, getSubschemaAtDataPointer, } from "./schema_pointers.js";
 import { ContractEventConsumersSchema, ContractJobQueueSchema, ContractResourcesSchema, ContractSchemaRefSchema, ContractStateSchema, } from "./protocol.js";
-export { buildCursorPage, buildPageResponse, ContractEventConsumerGroupSchema, ContractEventConsumerSelfSchema, ContractEventConsumersSchema, ContractEventConsumerUsesSchema, ContractJobQueueSchema, ContractJobsSchema, ContractKvResourceSchema, ContractResourceBindingsSchema, ContractResourcesSchema, ContractSchemaRefSchema, ContractStateSchema, ContractStateStoreSchema, ContractStoreResourceSchema, CursorPageInfoSchema, CursorPageSchema, CursorQuerySchema, EventConsumerResourceBindingSchema, EventHeaderSchema, InstalledServiceContractSchema, IsoDateSchema, JobsQueueBindingSchema, JobsResourceBindingSchema, KvResourceBindingSchema, normalizeCursorQuery, normalizePageQuery, PageRequestSchema, PageResponseSchema, StoreResourceBindingSchema, } from "./protocol.js";
+export { buildCursorPage, buildPageResponse, ContractEventConsumerGroupSchema, ContractEventConsumerSelfSchema, ContractEventConsumersSchema, ContractEventConsumerUsesSchema, ContractJobQueueSchema, ContractJobsSchema, ContractKvResourceSchema, ContractResourceBindingsSchema, ContractResourcesSchema, ContractSchemaRefSchema, ContractStateSchema, ContractStateStoreSchema, ContractStoreResourceSchema, CursorPageInfoSchema, CursorPageSchema, CursorQuerySchema, EventConsumerResourceBindingSchema, InstalledServiceContractSchema, IsoDateSchema, JobKeyConcurrencySchema, JobQueueDepthSchema, JobsQueueBindingSchema, JobsQueueDepthBindingSchema, JobsQueueKeyConcurrencyBindingSchema, JobsResourceBindingSchema, KvResourceBindingSchema, normalizeCursorQuery, normalizePageQuery, PageRequestSchema, PageResponseSchema, StoreResourceBindingSchema, } from "./protocol.js";
 export { assertDataPointersExistAndAreTokenable, getSubschemaAtDataPointer, } from "./schema_pointers.js";
 export const CONTRACT_FORMAT_V1 = "trellis.contract.v1";
 export const CATALOG_FORMAT_V1 = "trellis.catalog.v1";
@@ -108,6 +108,7 @@ const ContractOperationSchema = Type.Object({
     input: ContractSchemaRefSchema,
     progress: Type.Optional(ContractSchemaRefSchema),
     output: ContractSchemaRefSchema,
+    errors: Type.Optional(Type.Array(ContractErrorRefSchema)),
     transfer: Type.Optional(OperationTransferSchema),
     capabilities: Type.Optional(OperationCapabilitiesSchema),
     signals: Type.Optional(Type.Record(NonEmptyStringSchema, ContractOperationSignalSchema)),
@@ -554,6 +555,10 @@ function collectReachableSchemaNames(contract) {
         for (const signal of Object.values(operation.signals ?? {})) {
             collectSchemaRef(reachableSchemas, signal.input);
         }
+        for (const error of operation.errors ?? []) {
+            const declaration = Object.values(contract.errors ?? {}).find((decl) => decl.type === error.type);
+            collectSchemaRef(reachableSchemas, declaration?.schema);
+        }
     }
     for (const event of Object.values(contract.events ?? {})) {
         collectSchemaRef(reachableSchemas, event.event);
@@ -592,6 +597,19 @@ function projectRpcDeclaredErrors(contract) {
     const entries = Object.entries(contract.errors).filter(([, error]) => declaredErrorTypes.has(error.type));
     return entries.length > 0 ? Object.fromEntries(entries) : undefined;
 }
+function projectOperationDeclaredErrors(contract) {
+    if (!contract.errors) {
+        return undefined;
+    }
+    const declaredErrorTypes = new Set();
+    for (const operation of Object.values(contract.operations ?? {})) {
+        for (const error of operation.errors ?? []) {
+            declaredErrorTypes.add(error.type);
+        }
+    }
+    const entries = Object.entries(contract.errors).filter(([, error]) => declaredErrorTypes.has(error.type));
+    return entries.length > 0 ? Object.fromEntries(entries) : undefined;
+}
 function projectDigestResources(resources) {
     if (!resources?.kv && !resources?.store) {
         return undefined;
@@ -733,6 +751,12 @@ function projectDigestOperations(operations) {
                         },
                     }
                     : {}),
+                ...(operation.errors
+                    ? {
+                        errors: sortedUnique(operation.errors.map((error) => error.type))
+                            .map((type) => ({ type })),
+                    }
+                    : {}),
             },
         ];
     }));
@@ -939,6 +963,9 @@ function operation(operation) {
                 })),
             }
             : {}),
+        ...(operation.errors
+            ? { errors: operation.errors.map((error) => ({ type: error.type })) }
+            : {}),
         ...(operation.cancel !== undefined ? { cancel: operation.cancel } : {}),
         ...(operation.docs ? { docs: contractDocs(operation.docs) } : {}),
     };
@@ -1009,7 +1036,71 @@ function errorDecl(error) {
         ...(error.schema ? { schema: schemaRef(error.schema) } : {}),
     };
 }
-function jobQueue(queue) {
+function assertValidJsonPointerSyntax(queueType, pointer) {
+    if (!pointer.startsWith("/")) {
+        throw new Error(`jobs queue '${queueType}' keyConcurrency.key pointer segment '${pointer}' must start with '/'`);
+    }
+    for (let index = 0; index < pointer.length; index += 1) {
+        if (pointer[index] !== "~")
+            continue;
+        const escaped = pointer[index + 1];
+        if (escaped !== "0" && escaped !== "1") {
+            throw new Error(`jobs queue '${queueType}' keyConcurrency.key pointer segment '${pointer}' has invalid JSON Pointer escape at offset ${index}; use '~0' for '~' and '~1' for '/'`);
+        }
+        index += 1;
+    }
+}
+function assertValidJobKeyConcurrency(queueType, keyConcurrency) {
+    if (!keyConcurrency)
+        return;
+    if (keyConcurrency.key.length === 0) {
+        throw new Error(`jobs queue '${queueType}' keyConcurrency.key must contain at least one segment`);
+    }
+    for (const segment of keyConcurrency.key) {
+        if (segment.length === 0) {
+            throw new Error(`jobs queue '${queueType}' keyConcurrency.key segments must be non-empty strings`);
+        }
+        if (segment.startsWith("/")) {
+            assertValidJsonPointerSyntax(queueType, segment);
+        }
+    }
+    if (keyConcurrency.heartbeatIntervalMs !== undefined &&
+        keyConcurrency.heartbeatTtlMs !== undefined &&
+        keyConcurrency.heartbeatTtlMs <= keyConcurrency.heartbeatIntervalMs) {
+        throw new Error(`jobs queue '${queueType}' keyConcurrency.heartbeatTtlMs must exceed heartbeatIntervalMs`);
+    }
+}
+function jobKeyConcurrency(queueType, keyConcurrency) {
+    assertValidJobKeyConcurrency(queueType, keyConcurrency);
+    if (!keyConcurrency)
+        return undefined;
+    return {
+        key: [...keyConcurrency.key],
+        ...(keyConcurrency.maxActive !== undefined
+            ? { maxActive: keyConcurrency.maxActive }
+            : {}),
+        ...(keyConcurrency.heartbeatIntervalMs !== undefined
+            ? { heartbeatIntervalMs: keyConcurrency.heartbeatIntervalMs }
+            : {}),
+        ...(keyConcurrency.heartbeatTtlMs !== undefined
+            ? { heartbeatTtlMs: keyConcurrency.heartbeatTtlMs }
+            : {}),
+        ...(keyConcurrency.stalePolicy !== undefined
+            ? { stalePolicy: keyConcurrency.stalePolicy }
+            : {}),
+    };
+}
+function jobQueueDepth(queue) {
+    if (!queue)
+        return undefined;
+    return {
+        ...(queue.maxQueuedPerKey !== undefined
+            ? { maxQueuedPerKey: queue.maxQueuedPerKey }
+            : {}),
+        ...(queue.whenFull !== undefined ? { whenFull: queue.whenFull } : {}),
+    };
+}
+function jobQueue(queueType, queue) {
     return {
         payload: schemaRef(queue.payload),
         ...(queue.result ? { result: schemaRef(queue.result) } : {}),
@@ -1025,6 +1116,10 @@ function jobQueue(queue) {
         ...(queue.concurrency !== undefined
             ? { concurrency: queue.concurrency }
             : {}),
+        ...(queue.keyConcurrency
+            ? { keyConcurrency: jobKeyConcurrency(queueType, queue.keyConcurrency) }
+            : {}),
+        ...(queue.queue ? { queue: jobQueueDepth(queue.queue) } : {}),
         ...(queue.docs ? { docs: contractDocs(queue.docs) } : {}),
     };
 }
@@ -1093,7 +1188,14 @@ export function normalizeContractManifest(contract) {
             : {}),
         ...(contract.events ? { events: mapValues(contract.events, event) } : {}),
         ...(contract.feeds ? { feeds: mapValues(contract.feeds, feed) } : {}),
-        ...(contract.jobs ? { jobs: mapValues(contract.jobs, jobQueue) } : {}),
+        ...(contract.jobs
+            ? {
+                jobs: Object.fromEntries(Object.entries(contract.jobs).map(([queueType, queue]) => [
+                    queueType,
+                    jobQueue(queueType, queue),
+                ])),
+            }
+            : {}),
         ...(contract.eventConsumers
             ? {
                 eventConsumers: mapValues(contract.eventConsumers, eventConsumerGroup),
@@ -1140,7 +1242,12 @@ export function parseContractManifest(value) {
  */
 export function projectContractDigestManifest(contract) {
     const schemas = projectReachableSchemas(contract);
-    const errors = projectRpcDeclaredErrors(contract);
+    const rpcDeclaredErrors = projectRpcDeclaredErrors(contract);
+    const operationDeclaredErrors = projectOperationDeclaredErrors(contract);
+    const combinedErrors = { ...rpcDeclaredErrors, ...operationDeclaredErrors };
+    const errors = Object.keys(combinedErrors).length > 0
+        ? combinedErrors
+        : undefined;
     const state = projectDigestState(contract.state);
     const resources = projectDigestResources(contract.resources);
     const jobs = projectDigestJobs(contract.jobs);
@@ -1256,6 +1363,12 @@ function emitJobs(jobs) {
             ...(queue.concurrency !== undefined
                 ? { concurrency: queue.concurrency }
                 : {}),
+            ...(queue.keyConcurrency
+                ? {
+                    keyConcurrency: jobKeyConcurrency(queueType, queue.keyConcurrency),
+                }
+                : {}),
+            ...(queue.queue ? { queue: jobQueueDepth(queue.queue) } : {}),
             ...(queue.docs ? { docs: contractDocs(queue.docs) } : {}),
         },
     ]));
@@ -1480,6 +1593,9 @@ function emitContract(source) {
             if (operation.docs) {
                 emitted.docs = contractDocs(operation.docs);
             }
+            if (operation.errors && operation.errors.length > 0) {
+                emitted.errors = sortedUnique(operation.errors.map((errorName) => source.errors?.[errorName]?.type ?? errorName)).map((type) => ({ type }));
+            }
             return [name, emitted];
         }))
         : undefined;
@@ -1643,6 +1759,12 @@ function buildOwnedApi(source) {
             cancelCapabilities: projectCapabilities(operation.capabilities?.cancel, source.id, source.capabilities, `operation '${name}' cancel capabilities`) ?? [],
             controlCapabilities: projectCapabilities(operation.capabilities?.control, source.id, source.capabilities, `operation '${name}' control capabilities`) ?? [],
             cancel: operation.cancel,
+            errors: operation.errors,
+            declaredErrorTypes: operation.errors?.map((errorName) => source.errors?.[errorName]?.type ?? errorName),
+            runtimeErrors: operation.errors?.flatMap((errorName) => {
+                const runtimeError = localRuntimeErrors[errorName];
+                return runtimeError ? [runtimeError] : [];
+            }),
         },
     ]));
     const events = Object.fromEntries(Object.entries(source.events ?? {}).map(([name, event]) => {
@@ -1839,6 +1961,38 @@ export function defineError(options) {
     // fields on the generated class instance constructor return type.
     return DefinedErrorImpl;
 }
+/**
+ * Attaches Trellis validation UX metadata to a TypeBox schema node.
+ *
+ * When a request fails schema validation before handler dispatch, the metadata
+ * is used to produce a `SchemaValidationError` with stable field-level issue
+ * information that UIs can use without needing service-specific error handling.
+ *
+ * @template T The schema type.
+ * @param schema The TypeBox schema to annotate.
+ * @param extension The validation extension with labels, notes, and per-keyword issue hints.
+ * @returns The same schema type with `x-trellis-validation` attached.
+ *
+ * @example
+ * ```ts
+ * const MySchema = Type.Object({
+ *   name: withTrellisValidation(Type.String({ minLength: 1 }), {
+ *     label: "Name",
+ *     issues: {
+ *       minLength: {
+ *         code: "my.name.required",
+ *         message: "Enter a name.",
+ *       },
+ *     },
+ *   }),
+ * });
+ * ```
+ */
+export function withTrellisValidation(schema, extension) {
+    const cloned = { ...schema };
+    cloned["x-trellis-validation"] = extension;
+    return cloned;
+}
 function createUseHelper(getContractModule) {
     return ((spec) => {
         const contractModule = getContractModule();
@@ -2190,4 +2344,4 @@ export function defineDeviceContract(...args) {
     }
     return defineClientContract("device", registryOrBuild, maybeBuild);
 }
-export { canonicalizeJson, digestJson, isJsonValue, schema, unwrapSchema };
+export { canonicalizeJson, digestJson, isJsonValue, schema, sha256Base64urlSync, unwrapSchema, };

package/esm/contract_support/protocol.d.ts

@@ -65,6 +65,19 @@ export declare const ContractStateSchema: Type.TRecord<"^.*$", Type.TObject<{
     }>>;
 }>>;
 export type ContractState = Static<typeof ContractStateSchema>;
+export declare const JobKeyConcurrencySchema: Type.TObject<{
+    key: Type.TArray<Type.TString>;
+    maxActive: Type.TOptional<Type.TInteger>;
+    heartbeatIntervalMs: Type.TOptional<Type.TInteger>;
+    heartbeatTtlMs: Type.TOptional<Type.TInteger>;
+    stalePolicy: Type.TOptional<Type.TUnion<[Type.TLiteral<"fail-stale">, Type.TLiteral<"block">]>>;
+}>;
+export type JobKeyConcurrency = Static<typeof JobKeyConcurrencySchema>;
+export declare const JobQueueDepthSchema: Type.TObject<{
+    maxQueuedPerKey: Type.TOptional<Type.TInteger>;
+    whenFull: Type.TOptional<Type.TUnion<[Type.TLiteral<"reject">, Type.TLiteral<"coalesce">, Type.TLiteral<"replace-oldest">]>>;
+}>;
+export type JobQueueDepth = Static<typeof JobQueueDepthSchema>;
 export declare const ContractJobQueueSchema: Type.TObject<{
     payload: Type.TObject<{
         schema: Type.TString;
@@ -80,6 +93,17 @@ export declare const ContractJobQueueSchema: Type.TObject<{
     logs: Type.TOptional<Type.TBoolean>;
     dlq: Type.TOptional<Type.TBoolean>;
     concurrency: Type.TOptional<Type.TInteger>;
+    keyConcurrency: Type.TOptional<Type.TObject<{
+        key: Type.TArray<Type.TString>;
+        maxActive: Type.TOptional<Type.TInteger>;
+        heartbeatIntervalMs: Type.TOptional<Type.TInteger>;
+        heartbeatTtlMs: Type.TOptional<Type.TInteger>;
+        stalePolicy: Type.TOptional<Type.TUnion<[Type.TLiteral<"fail-stale">, Type.TLiteral<"block">]>>;
+    }>>;
+    queue: Type.TOptional<Type.TObject<{
+        maxQueuedPerKey: Type.TOptional<Type.TInteger>;
+        whenFull: Type.TOptional<Type.TUnion<[Type.TLiteral<"reject">, Type.TLiteral<"coalesce">, Type.TLiteral<"replace-oldest">]>>;
+    }>>;
     docs: Type.TOptional<Type.TObject<{
         summary: Type.TOptional<Type.TString>;
         markdown: Type.TString;
@@ -101,6 +125,17 @@ export declare const ContractJobsSchema: Type.TRecord<"^.*$", Type.TObject<{
     logs: Type.TOptional<Type.TBoolean>;
     dlq: Type.TOptional<Type.TBoolean>;
     concurrency: Type.TOptional<Type.TInteger>;
+    keyConcurrency: Type.TOptional<Type.TObject<{
+        key: Type.TArray<Type.TString>;
+        maxActive: Type.TOptional<Type.TInteger>;
+        heartbeatIntervalMs: Type.TOptional<Type.TInteger>;
+        heartbeatTtlMs: Type.TOptional<Type.TInteger>;
+        stalePolicy: Type.TOptional<Type.TUnion<[Type.TLiteral<"fail-stale">, Type.TLiteral<"block">]>>;
+    }>>;
+    queue: Type.TOptional<Type.TObject<{
+        maxQueuedPerKey: Type.TOptional<Type.TInteger>;
+        whenFull: Type.TOptional<Type.TUnion<[Type.TLiteral<"reject">, Type.TLiteral<"coalesce">, Type.TLiteral<"replace-oldest">]>>;
+    }>>;
     docs: Type.TOptional<Type.TObject<{
         summary: Type.TOptional<Type.TString>;
         markdown: Type.TString;
@@ -183,6 +218,19 @@ export declare const StoreResourceBindingSchema: Type.TObject<{
     maxTotalBytes: Type.TOptional<Type.TInteger>;
 }>;
 export type StoreResourceBinding = Static<typeof StoreResourceBindingSchema>;
+export declare const JobsQueueKeyConcurrencyBindingSchema: Type.TObject<{
+    key: Type.TArray<Type.TString>;
+    maxActive: Type.TInteger;
+    heartbeatIntervalMs: Type.TInteger;
+    heartbeatTtlMs: Type.TInteger;
+    stalePolicy: Type.TUnion<[Type.TLiteral<"fail-stale">, Type.TLiteral<"block">]>;
+}>;
+export type JobsQueueKeyConcurrencyBinding = Static<typeof JobsQueueKeyConcurrencyBindingSchema>;
+export declare const JobsQueueDepthBindingSchema: Type.TObject<{
+    maxQueuedPerKey: Type.TInteger;
+    whenFull: Type.TUnion<[Type.TLiteral<"reject">, Type.TLiteral<"coalesce">, Type.TLiteral<"replace-oldest">]>;
+}>;
+export type JobsQueueDepthBinding = Static<typeof JobsQueueDepthBindingSchema>;
 export declare const JobsQueueBindingSchema: Type.TObject<{
     queueType: Type.TString;
     publishPrefix: Type.TString;
@@ -202,6 +250,17 @@ export declare const JobsQueueBindingSchema: Type.TObject<{
     logs: Type.TBoolean;
     dlq: Type.TBoolean;
     concurrency: Type.TInteger;
+    keyConcurrency: Type.TOptional<Type.TObject<{
+        key: Type.TArray<Type.TString>;
+        maxActive: Type.TInteger;
+        heartbeatIntervalMs: Type.TInteger;
+        heartbeatTtlMs: Type.TInteger;
+        stalePolicy: Type.TUnion<[Type.TLiteral<"fail-stale">, Type.TLiteral<"block">]>;
+    }>>;
+    queue: Type.TOptional<Type.TObject<{
+        maxQueuedPerKey: Type.TInteger;
+        whenFull: Type.TUnion<[Type.TLiteral<"reject">, Type.TLiteral<"coalesce">, Type.TLiteral<"replace-oldest">]>;
+    }>>;
 }>;
 export type JobsQueueBinding = Static<typeof JobsQueueBindingSchema>;
 export declare const JobsResourceBindingSchema: Type.TObject<{
@@ -226,6 +285,17 @@ export declare const JobsResourceBindingSchema: Type.TObject<{
         logs: Type.TBoolean;
         dlq: Type.TBoolean;
         concurrency: Type.TInteger;
+        keyConcurrency: Type.TOptional<Type.TObject<{
+            key: Type.TArray<Type.TString>;
+            maxActive: Type.TInteger;
+            heartbeatIntervalMs: Type.TInteger;
+            heartbeatTtlMs: Type.TInteger;
+            stalePolicy: Type.TUnion<[Type.TLiteral<"fail-stale">, Type.TLiteral<"block">]>;
+        }>>;
+        queue: Type.TOptional<Type.TObject<{
+            maxQueuedPerKey: Type.TInteger;
+            whenFull: Type.TUnion<[Type.TLiteral<"reject">, Type.TLiteral<"coalesce">, Type.TLiteral<"replace-oldest">]>;
+        }>>;
     }>>;
 }>;
 export type JobsResourceBinding = Static<typeof JobsResourceBindingSchema>;
@@ -276,6 +346,17 @@ export declare const ContractResourceBindingsSchema: Type.TObject<{
             logs: Type.TBoolean;
             dlq: Type.TBoolean;
             concurrency: Type.TInteger;
+            keyConcurrency: Type.TOptional<Type.TObject<{
+                key: Type.TArray<Type.TString>;
+                maxActive: Type.TInteger;
+                heartbeatIntervalMs: Type.TInteger;
+                heartbeatTtlMs: Type.TInteger;
+                stalePolicy: Type.TUnion<[Type.TLiteral<"fail-stale">, Type.TLiteral<"block">]>;
+            }>>;
+            queue: Type.TOptional<Type.TObject<{
+                maxQueuedPerKey: Type.TInteger;
+                whenFull: Type.TUnion<[Type.TLiteral<"reject">, Type.TLiteral<"coalesce">, Type.TLiteral<"replace-oldest">]>;
+            }>>;
         }>>;
     }>>;
     eventConsumers: Type.TOptional<Type.TRecord<"^.*$", Type.TObject<{
@@ -329,6 +410,17 @@ export declare const InstalledServiceContractSchema: Type.TObject<{
                 logs: Type.TBoolean;
                 dlq: Type.TBoolean;
                 concurrency: Type.TInteger;
+                keyConcurrency: Type.TOptional<Type.TObject<{
+                    key: Type.TArray<Type.TString>;
+                    maxActive: Type.TInteger;
+                    heartbeatIntervalMs: Type.TInteger;
+                    heartbeatTtlMs: Type.TInteger;
+                    stalePolicy: Type.TUnion<[Type.TLiteral<"fail-stale">, Type.TLiteral<"block">]>;
+                }>>;
+                queue: Type.TOptional<Type.TObject<{
+                    maxQueuedPerKey: Type.TInteger;
+                    whenFull: Type.TUnion<[Type.TLiteral<"reject">, Type.TLiteral<"coalesce">, Type.TLiteral<"replace-oldest">]>;
+                }>>;
             }>>;
         }>>;
         eventConsumers: Type.TOptional<Type.TRecord<"^.*$", Type.TObject<{
@@ -346,13 +438,6 @@ export declare const InstalledServiceContractSchema: Type.TObject<{
 }>;
 export type InstalledServiceContract = Static<typeof InstalledServiceContractSchema>;
 export declare const IsoDateSchema: Type.TCodec<Type.TString, Date>;
-export declare const EventHeaderSchema: Type.TObject<{
-    header: Type.TObject<{
-        id: Type.TString;
-        time: Type.TCodec<Type.TString, Date>;
-    }>;
-}>;
-export type EventHeader = Static<typeof EventHeaderSchema>;
 /** Schema for a bounded pagination request. */
 export declare const PageRequestSchema: Type.TObject<{
     offset: Type.TOptional<Type.TInteger>;

package/esm/contract_support/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/contract_support/protocol.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/contract_support/protocol.ts"],"names":[],"mappings":"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"}

package/esm/contract_support/protocol.js

@@ -47,6 +47,24 @@ export const ContractStateStoreSchema = Type.Object({
     docs: Type.Optional(ContractDocsSchema),
 });
 export const ContractStateSchema = Type.Record(Type.String({ minLength: 1 }), ContractStateStoreSchema);
+export const JobKeyConcurrencySchema = Type.Object({
+    key: Type.Array(Type.String({ minLength: 1 }), { minItems: 1 }),
+    maxActive: Type.Optional(Type.Integer({ minimum: 1 })),
+    heartbeatIntervalMs: Type.Optional(Type.Integer({ minimum: 1 })),
+    heartbeatTtlMs: Type.Optional(Type.Integer({ minimum: 1 })),
+    stalePolicy: Type.Optional(Type.Union([
+        Type.Literal("fail-stale"),
+        Type.Literal("block"),
+    ])),
+});
+export const JobQueueDepthSchema = Type.Object({
+    maxQueuedPerKey: Type.Optional(Type.Integer({ minimum: 0 })),
+    whenFull: Type.Optional(Type.Union([
+        Type.Literal("reject"),
+        Type.Literal("coalesce"),
+        Type.Literal("replace-oldest"),
+    ])),
+});
 export const ContractJobQueueSchema = Type.Object({
     payload: ContractSchemaRefSchema,
     result: Type.Optional(ContractSchemaRefSchema),
@@ -58,6 +76,8 @@ export const ContractJobQueueSchema = Type.Object({
     logs: Type.Optional(Type.Boolean()),
     dlq: Type.Optional(Type.Boolean()),
     concurrency: Type.Optional(Type.Integer({ minimum: 1 })),
+    keyConcurrency: Type.Optional(JobKeyConcurrencySchema),
+    queue: Type.Optional(JobQueueDepthSchema),
     docs: Type.Optional(ContractDocsSchema),
 });
 export const ContractJobsSchema = Type.Record(Type.String({ minLength: 1 }), ContractJobQueueSchema);
@@ -94,6 +114,24 @@ export const StoreResourceBindingSchema = Type.Object({
     maxObjectBytes: Type.Optional(Type.Integer({ minimum: 1 })),
     maxTotalBytes: Type.Optional(Type.Integer({ minimum: 1 })),
 });
+export const JobsQueueKeyConcurrencyBindingSchema = Type.Object({
+    key: Type.Array(Type.String({ minLength: 1 }), { minItems: 1 }),
+    maxActive: Type.Integer({ minimum: 1 }),
+    heartbeatIntervalMs: Type.Integer({ minimum: 1 }),
+    heartbeatTtlMs: Type.Integer({ minimum: 1 }),
+    stalePolicy: Type.Union([
+        Type.Literal("fail-stale"),
+        Type.Literal("block"),
+    ]),
+});
+export const JobsQueueDepthBindingSchema = Type.Object({
+    maxQueuedPerKey: Type.Integer({ minimum: 0 }),
+    whenFull: Type.Union([
+        Type.Literal("reject"),
+        Type.Literal("coalesce"),
+        Type.Literal("replace-oldest"),
+    ]),
+});
 export const JobsQueueBindingSchema = Type.Object({
     queueType: Type.String({ minLength: 1 }),
     publishPrefix: Type.String({ minLength: 1 }),
@@ -109,6 +147,8 @@ export const JobsQueueBindingSchema = Type.Object({
     logs: Type.Boolean(),
     dlq: Type.Boolean(),
     concurrency: Type.Integer({ minimum: 1 }),
+    keyConcurrency: Type.Optional(JobsQueueKeyConcurrencyBindingSchema),
+    queue: Type.Optional(JobsQueueDepthBindingSchema),
 });
 export const JobsResourceBindingSchema = Type.Object({
     namespace: Type.String({ minLength: 1 }),
@@ -140,12 +180,6 @@ export const InstalledServiceContractSchema = Type.Object({
 export const IsoDateSchema = Type.Codec(Type.String({ format: "date-time" }))
     .Decode((value) => parseIsoDate(value))
     .Encode((value) => formatIsoDate(value));
-export const EventHeaderSchema = Type.Object({
-    header: Type.Object({
-        id: Type.String(),
-        time: IsoDateSchema,
-    }),
-});
 /** Schema for a bounded pagination request. */
 export const PageRequestSchema = Type.Object({
     offset: Type.Optional(Type.Integer({ minimum: 0 })),
@@ -203,7 +237,7 @@ export function buildPageResponse(entries, totalCount, query, maxLimit) {
 /** Schema for a cursor pagination query. */
 export const CursorQuerySchema = Type.Object({
     cursor: Type.Optional(Type.String({ minLength: 1 })),
-    limit: Type.Optional(Type.Integer({ minimum: 0 })),
+    limit: Type.Optional(Type.Integer({ minimum: 0, maximum: 500 })),
 });
 /** Schema for cursor pagination response metadata. */
 export const CursorPageInfoSchema = Type.Object({

package/esm/contract_support/runtime.d.ts

@@ -51,11 +51,14 @@ export type FeedDesc<I extends SchemaLike = SchemaLike, E extends SchemaLike = S
     event: E;
     subscribeCapabilities: readonly string[];
 };
-export type OperationDesc<I extends SchemaLike = SchemaLike, P extends SchemaLike | undefined = SchemaLike | undefined, O extends SchemaLike | undefined = SchemaLike | undefined> = {
+export type OperationDesc<I extends SchemaLike = SchemaLike, P extends SchemaLike | undefined = SchemaLike | undefined, O extends SchemaLike | undefined = SchemaLike | undefined, E extends readonly string[] | undefined = readonly string[] | undefined, TRuntimeErrors extends readonly RuntimeRpcErrorDesc[] | undefined = readonly RuntimeRpcErrorDesc[] | undefined> = {
     subject: string;
     input: I;
     progress?: P;
     output?: O;
+    errors?: E;
+    runtimeErrors?: TRuntimeErrors;
+    declaredErrorTypes?: readonly string[];
     transfer?: {
         direction: "send";
         store: string;

package/esm/contract_support/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/contract_support/runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/contract_support/runtime.ts"],"names":[],"mappings":"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"}

package/esm/errors/SchemaValidationError.d.ts

@@ -0,0 +1,49 @@
+import Type, { type Static } from "typebox";
+import { TrellisError } from "./TrellisError.js";
+export declare const SchemaValidationIssueSchema: Type.TObject<{
+    path: Type.TString;
+    schemaPath: Type.TOptional<Type.TString>;
+    keyword: Type.TString;
+    code: Type.TString;
+    message: Type.TString;
+    label: Type.TOptional<Type.TString>;
+    note: Type.TOptional<Type.TString>;
+    i18nKey: Type.TOptional<Type.TString>;
+    severity: Type.TOptional<Type.TUnion<[Type.TLiteral<"error">, Type.TLiteral<"warning">, Type.TLiteral<"info">]>>;
+    params: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
+}>;
+export type SchemaValidationIssue = Static<typeof SchemaValidationIssueSchema>;
+export declare const SchemaValidationErrorDataSchema: Type.TObject<{
+    id: Type.TString;
+    type: Type.TLiteral<"SchemaValidationError">;
+    message: Type.TString;
+    issues: Type.TArray<Type.TObject<{
+        path: Type.TString;
+        schemaPath: Type.TOptional<Type.TString>;
+        keyword: Type.TString;
+        code: Type.TString;
+        message: Type.TString;
+        label: Type.TOptional<Type.TString>;
+        note: Type.TOptional<Type.TString>;
+        i18nKey: Type.TOptional<Type.TString>;
+        severity: Type.TOptional<Type.TUnion<[Type.TLiteral<"error">, Type.TLiteral<"warning">, Type.TLiteral<"info">]>>;
+        params: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
+    }>>;
+    context: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
+    traceId: Type.TOptional<Type.TString>;
+}>;
+export type SchemaValidationErrorData = Static<typeof SchemaValidationErrorDataSchema>;
+export declare class SchemaValidationError extends TrellisError<SchemaValidationErrorData> {
+    #private;
+    readonly name: "SchemaValidationError";
+    constructor(options: {
+        issues: SchemaValidationIssue[];
+        context?: Record<string, unknown>;
+        cause?: unknown;
+        id?: string;
+    });
+    /** The validation issues that caused this error. */
+    get issues(): readonly SchemaValidationIssue[];
+    toSerializable(): SchemaValidationErrorData;
+}
+//# sourceMappingURL=SchemaValidationError.d.ts.map

package/esm/errors/SchemaValidationError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaValidationError.d.ts","sourceRoot":"","sources":["../../src/errors/SchemaValidationError.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,EAAE,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,eAAO,MAAM,2BAA2B;;;;;;;;;;;EAetC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAE/E,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;EAO1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,MAAM,CAC5C,OAAO,+BAA+B,CACvC,CAAC;AAEF,qBAAa,qBACX,SAAQ,YAAY,CAAC,yBAAyB,CAAC;;IAC/C,SAAkB,IAAI,EAAG,uBAAuB,CAAU;gBAIxD,OAAO,EAAE;QACP,MAAM,EAAE,qBAAqB,EAAE,CAAC;QAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,EAAE,CAAC,EAAE,MAAM,CAAC;KACb;IAUH,oDAAoD;IACpD,IAAI,MAAM,IAAI,SAAS,qBAAqB,EAAE,CAE7C;IAEQ,cAAc,IAAI,yBAAyB;CAOrD"}