@notionhq/workers 0.4.0 → 0.6.0

package/dist/alpha/json-schema.d.ts

@@ -0,0 +1,117 @@
+/**
+ * JSON Schema types compatible with both Anthropic and OpenAI structured
+ * output APIs.
+ *
+ * Constraints enforced by this type (intersection of both providers):
+ * - Objects must have `additionalProperties: false`
+ * - All object properties should be listed in `required`
+ *   (use `anyOf` with `null` for optional fields)
+ * - No recursive schemas
+ * - No `allOf`, `not`, `if/then/else`
+ * - No string constraints (`minLength`, `maxLength`, `pattern`)
+ * - No number constraints (`minimum`, `maximum`, `multipleOf`)
+ * - Array `minItems` limited to 0 or 1; no `maxItems`
+ * - String `format` limited to: date-time, time, date, duration,
+ *   email, hostname, ipv4, ipv6, uuid
+ * - `$ref` and `$defs` supported (no external refs)
+ */
+/**
+ * String formats supported by both Anthropic and OpenAI structured outputs.
+ */
+export type JSONSchemaStringFormat = "date-time" | "time" | "date" | "duration" | "email" | "hostname" | "ipv4" | "ipv6" | "uuid";
+interface ForbiddenCompositionKeywords {
+    anyOf?: never;
+    allOf?: never;
+    not?: never;
+    if?: never;
+    then?: never;
+    else?: never;
+}
+export interface JSONSchemaStringDef<T extends string = string> extends ForbiddenCompositionKeywords {
+    type: "string";
+    description?: string;
+    format?: JSONSchemaStringFormat;
+    enum?: readonly T[];
+}
+export interface JSONSchemaNumberDef<T extends number = number> extends ForbiddenCompositionKeywords {
+    type: "number" | "integer";
+    description?: string;
+    enum?: readonly T[];
+}
+export interface JSONSchemaBooleanDef extends ForbiddenCompositionKeywords {
+    type: "boolean";
+    description?: string;
+}
+export interface JSONSchemaNullDef extends ForbiddenCompositionKeywords {
+    type: "null";
+    description?: string;
+}
+export interface JSONSchemaArrayDef<E = unknown> extends ForbiddenCompositionKeywords {
+    type: "array";
+    description?: string;
+    items: JSONSchema<E>;
+    minItems?: 0 | 1;
+}
+export interface JSONSchemaObjectDef<T extends Record<string, unknown> = Record<string, unknown>> extends ForbiddenCompositionKeywords {
+    type: "object";
+    description?: string;
+    properties: {
+        [K in keyof T]-?: JSONSchema<T[K]>;
+    };
+    required: readonly (keyof T & string)[];
+    additionalProperties: false;
+    $defs?: Record<string, AnyJSONSchema>;
+}
+export interface JSONSchemaRefDef extends ForbiddenCompositionKeywords {
+    $ref: string;
+    description?: string;
+}
+export interface JSONSchemaAnyOfDef<T = unknown> {
+    anyOf: readonly JSONSchema<T>[];
+    description?: string;
+}
+export type AnyJSONSchema = JSONSchemaStringDef | JSONSchemaNumberDef | JSONSchemaBooleanDef | JSONSchemaNullDef | JSONSchemaArrayDef | JSONSchemaObjectDef | JSONSchemaRefDef | JSONSchemaAnyOfDef;
+/**
+ * Maps a TypeScript type T to its corresponding JSON Schema definition.
+ *
+ * Uses `[T] extends [X]` (non-distributing) so that union types like
+ * `string | number` fall through to `AnyJSONSchema` instead of distributing
+ * into `JSONSchemaStringDef | JSONSchemaNumberDef`.
+ *
+ * The `T & X` intersections (e.g. `T & string`) satisfy the generic
+ * constraints on each def without widening T.
+ *
+ * A `$ref` is always valid in any schema position, so `JSONSchemaRefDef`
+ * is unioned in at the end.
+ */
+type JSONSchemaFor<T> = JSONSchemaRefDef | ([T] extends [string] ? JSONSchemaStringDef<T & string> : [T] extends [number] ? JSONSchemaNumberDef<T & number> : [T] extends [boolean] ? JSONSchemaBooleanDef : [T] extends [readonly (infer E)[]] ? JSONSchemaArrayDef<E> : [T] extends [Record<string, unknown>] ? JSONSchemaObjectDef<T & Record<string, unknown>> : AnyJSONSchema);
+/**
+ * Wraps a non-null schema in an `anyOf` with `{ type: "null" }` for
+ * nullable types (e.g. `string | null`).
+ */
+type JSONSchemaNullable<T> = {
+    anyOf: readonly [JSONSchemaFor<T>, JSONSchemaNullDef];
+    description?: string;
+};
+/**
+ * A JSON Schema definition compatible with both Anthropic and OpenAI
+ * structured output APIs.
+ *
+ * When the generic parameter `T` is provided, the schema structure is
+ * constrained at compile time to match `T`:
+ *
+ * ```ts
+ * // Schema is checked against the type:
+ * const schema: JSONSchema<{ name: string }> = {
+ *   type: "object",
+ *   properties: { name: { type: "string" } },
+ *   required: ["name"],
+ *   additionalProperties: false,
+ * };
+ * ```
+ *
+ * @template T - The TypeScript type the schema should describe.
+ */
+export type JSONSchema<T = unknown> = unknown extends T ? AnyJSONSchema : null extends T ? JSONSchemaNullable<NonNullable<T>> : JSONSchemaFor<T>;
+export {};
+//# sourceMappingURL=json-schema.d.ts.map

package/dist/alpha/json-schema.d.ts.map

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

package/dist/alpha/manifest.d.ts

@@ -0,0 +1,44 @@
+/**
+ * A capability type identifier (e.g. "sync", "tool"). The set of types the
+ * build tool can discover is defined by `CAPABILITY_TYPES` in the CLI; the
+ * manifest treats the type as an opaque string.
+ */
+export type CapabilityType = string;
+/**
+ * One capability in the manifest: its type, its key (derived from its
+ * filename), and its handler-free configuration.
+ */
+export type CapabilityManifestEntry = {
+    type: CapabilityType;
+    key: string;
+    config: unknown;
+};
+/**
+ * One database in the manifest: its key (derived from its filename under
+ * `src/databases/`, or from the owning sync's key for inline databases)
+ * and its configuration, with `relation` properties resolved to
+ * `relatedDatabaseKey` references.
+ */
+export type DatabaseManifestEntry = {
+    key: string;
+    config: unknown;
+};
+/**
+ * One pacer in the manifest: its stable name and its rate-limit config.
+ */
+export type PacerManifestEntry = {
+    key: string;
+    config: unknown;
+};
+/**
+ * The full worker manifest, emitted by `notion-workers build` as
+ * `dist/manifest.json` and read by the platform at deploy time. This is a
+ * complete, static description of the worker.
+ */
+export type WorkerManifest = {
+    sdkVersion: string;
+    databases: DatabaseManifestEntry[];
+    pacers: PacerManifestEntry[];
+    capabilities: CapabilityManifestEntry[];
+};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/alpha/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/alpha/manifest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,qBAAqB,EAAE,CAAC;IACnC,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,YAAY,EAAE,uBAAuB,EAAE,CAAC;CACxC,CAAC"}

package/dist/alpha/output.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Writes a notion_output envelope to stdout using the shared wire format.
+ * The platform runner scans a run's log stream for this envelope to
+ * recover the capability's result.
+ */
+export declare function writeOutput(value: unknown): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/alpha/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/alpha/output.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAEhD"}

package/dist/alpha/output.js

@@ -0,0 +1,8 @@
+function writeOutput(value) {
+  process.stdout.write(`
+<__notion_output__>${JSON.stringify(value)}</__notion_output__>
+`);
+}
+export {
+  writeOutput
+};

package/dist/alpha/pacer.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Configuration for a pacer that rate-limits requests to an external API.
+ * When multiple syncs share a pacer, the platform apportions the budget
+ * across them.
+ */
+export type PacerConfig = {
+    /** Maximum number of requests allowed per interval. */
+    allowedRequests: number;
+    /** The interval window in milliseconds. */
+    intervalMs: number;
+};
+/**
+ * Runtime pacing state for one pacer, as exchanged with the platform: the
+ * server sends entries with the *apportioned* budget (the declared budget
+ * divided across the syncs sharing the pacer), and the SDK returns the
+ * updated entries after a run so the server can persist `lastScheduledAtMs`.
+ * The wire shape matches v1.
+ */
+export type PacerEntry = {
+    lastScheduledAtMs: number;
+    /** Server-provided (apportioned) request budget. */
+    allowedRequests: number;
+    /** Server-provided interval window in milliseconds. */
+    intervalMs: number;
+};
+/**
+ * A pacer as returned by {@link createPacer}.
+ */
+export type Pacer = {
+    _tag: "pacer";
+    name: string;
+    config: PacerConfig;
+    /**
+     * Wait until a request can proceed under this pacer's rate limit.
+     * Call this before every API request the pacer covers.
+     *
+     * Requests are evenly spaced over the interval window. Inside a sync
+     * run, pacing continues from the server-provided state (which carries
+     * the budget apportioned across the syncs sharing this pacer); outside
+     * one, pacing starts fresh from the declared config.
+     */
+    wait(): Promise<void>;
+};
+/**
+ * Declare a pacer for rate-limiting requests to an external API.
+ *
+ * Like databases, a pacer is a named resource that can live anywhere —
+ * typically in a shared module next to the API client it paces. Unlike
+ * databases, a pacer is not attached to sync config: handlers use as many
+ * pacers as they need by importing them and calling `wait()`. Creating a
+ * pacer registers it, so every pacer in a module the worker imports is
+ * included in the manifest automatically.
+ *
+ * The `name` is the pacer's stable identity across deploys — the platform
+ * uses it to persist pacing state. Two `createPacer(...)` calls sharing a
+ * name fail the build; share one instance via import instead.
+ *
+ * @example
+ * ```ts
+ * // src/lib/jira.ts
+ * import { createPacer } from "@notionhq/workers/alpha/pacer";
+ *
+ * export const jiraPacer = createPacer("jira", {
+ *   allowedRequests: 10,
+ *   intervalMs: 1000,
+ * });
+ *
+ * // src/syncs/issues.ts — inside the handler:
+ * //   await jiraPacer.wait();
+ * //   const issues = await fetchIssues();
+ * ```
+ */
+export declare function createPacer(name: string, config: PacerConfig): Pacer;
+//# sourceMappingURL=pacer.d.ts.map

package/dist/alpha/pacer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pacer.d.ts","sourceRoot":"","sources":["../../src/alpha/pacer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG;IACzB,uDAAuD;IACvD,eAAe,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,eAAe,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;CACnB,CAAC;AAsBF;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB;;;;;;;;OAQG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,KAAK,CA0CpE"}

package/dist/alpha/pacer.js

@@ -0,0 +1,66 @@
+const REGISTRY_KEY = /* @__PURE__ */ Symbol.for("@notionhq/workers/alpha/pacer-registry");
+const STATE_KEY = /* @__PURE__ */ Symbol.for("@notionhq/workers/alpha/pacer-state");
+function registry() {
+  const holder = globalThis;
+  holder[REGISTRY_KEY] ??= /* @__PURE__ */ new Map();
+  return holder[REGISTRY_KEY];
+}
+function state() {
+  const holder = globalThis;
+  holder[STATE_KEY] ??= /* @__PURE__ */ new Map();
+  return holder[STATE_KEY];
+}
+function createPacer(name, config) {
+  if (!name || typeof name !== "string") {
+    throw new Error("Pacer name must be a non-empty string");
+  }
+  if (registry().has(name)) {
+    throw new Error(
+      `Two distinct pacers are named "${name}". A name identifies one pacer \u2014 share a single createPacer(...) instance via import instead of declaring it twice`
+    );
+  }
+  const pacer = {
+    _tag: "pacer",
+    name,
+    config,
+    async wait() {
+      const entry = state().get(name) ?? {
+        lastScheduledAtMs: 0,
+        allowedRequests: config.allowedRequests,
+        intervalMs: config.intervalMs
+      };
+      const paceMs = Math.ceil(entry.intervalMs / entry.allowedRequests);
+      const now = Date.now();
+      const scheduledAtMs = Math.max(entry.lastScheduledAtMs + paceMs, now);
+      const delayMs = scheduledAtMs - now;
+      state().set(name, { ...entry, lastScheduledAtMs: scheduledAtMs });
+      if (delayMs > 0) {
+        await new Promise((resolve) => setTimeout(resolve, delayMs));
+      }
+    }
+  };
+  registry().set(name, pacer);
+  return pacer;
+}
+function initPacerState(runtimePacers) {
+  state().clear();
+  for (const [name, entry] of Object.entries(runtimePacers ?? {})) {
+    state().set(name, entry);
+  }
+}
+function pacerStates() {
+  return Object.fromEntries(state());
+}
+function registeredPacers() {
+  return Array.from(registry().values());
+}
+function clearRegisteredPacers() {
+  registry().clear();
+}
+export {
+  clearRegisteredPacers,
+  createPacer,
+  initPacerState,
+  pacerStates,
+  registeredPacers
+};

package/dist/alpha/pacer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pacer.test.d.ts.map

package/dist/alpha/pacer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pacer.test.d.ts","sourceRoot":"","sources":["../../src/alpha/pacer.test.ts"],"names":[],"mappings":""}

package/dist/alpha/schedule.d.ts

@@ -0,0 +1,6 @@
+import type { NormalizedSchedule, Schedule } from "./types.js";
+/**
+ * Parses a user-friendly schedule string into the normalized backend format.
+ */
+export declare function parseSchedule(schedule: Schedule): NormalizedSchedule;
+//# sourceMappingURL=schedule.d.ts.map

package/dist/alpha/schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../../src/alpha/schedule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAY,MAAM,YAAY,CAAC;AASzE;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,kBAAkB,CAwCpE"}

package/dist/alpha/schedule.js

@@ -0,0 +1,43 @@
+const MS_PER_MINUTE = 60 * 1e3;
+const MS_PER_HOUR = 60 * MS_PER_MINUTE;
+const MS_PER_DAY = 24 * MS_PER_HOUR;
+const MIN_INTERVAL_MS = MS_PER_MINUTE;
+const MAX_INTERVAL_MS = 7 * MS_PER_DAY;
+function parseSchedule(schedule) {
+  if (schedule === "continuous") {
+    return { type: "continuous" };
+  }
+  if (schedule === "manual") {
+    return { type: "manual" };
+  }
+  const match = schedule.match(/^(\d+)(m|h|d)$/);
+  if (!match?.[1] || !match[2]) {
+    throw new Error(
+      `Invalid schedule format: "${schedule}". Use "continuous" or an interval like "30m", "1h", "1d".`
+    );
+  }
+  const value = parseInt(match[1], 10);
+  const unit = match[2];
+  let intervalMs;
+  switch (unit) {
+    case "m":
+      intervalMs = value * MS_PER_MINUTE;
+      break;
+    case "h":
+      intervalMs = value * MS_PER_HOUR;
+      break;
+    case "d":
+      intervalMs = value * MS_PER_DAY;
+      break;
+  }
+  if (intervalMs < MIN_INTERVAL_MS) {
+    throw new Error(`Schedule interval must be at least 1 minute. Got: "${schedule}"`);
+  }
+  if (intervalMs > MAX_INTERVAL_MS) {
+    throw new Error(`Schedule interval must be at most 7 days. Got: "${schedule}"`);
+  }
+  return { type: "interval", intervalMs };
+}
+export {
+  parseSchedule
+};

package/dist/alpha/schedule.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schedule.test.d.ts.map

package/dist/alpha/schedule.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.test.d.ts","sourceRoot":"","sources":["../../src/alpha/schedule.test.ts"],"names":[],"mappings":""}

package/dist/alpha/schema-builder.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Zod-like builder for JSONSchema objects.
+ *
+ * Guarantees output always complies with the model provider constraints
+ * enforced by `json-schema.ts` — all object properties in `required`,
+ * `additionalProperties: false`, no forbidden composition keywords, etc.
+ *
+ * @example
+ * ```ts
+ * import { j } from "@notionhq/workers/alpha/schema-builder";
+ *
+ * const schema = j.object({
+ *   foo: j.enum("a", "b", "c").describe("The foo field"),
+ *   bar: j.string(),
+ *   count: j.number(),
+ *   tags: j.array(j.string()),
+ *   nickname: j.string().nullable(),
+ *   createdAt: j.datetime(),
+ * });
+ * ```
+ */
+import type { AnyJSONSchema, JSONSchema } from "./json-schema.js";
+declare const SCHEMA: unique symbol;
+export interface SchemaBuilder<T> {
+    readonly [SCHEMA]: AnyJSONSchema;
+    /** Set the JSONSchema description field. Chainable. */
+    describe(text: string): SchemaBuilder<T>;
+    /** Wrap in anyOf with null. Chainable. */
+    nullable(): SchemaBuilder<T | null>;
+}
+/** Extracts `T` from `SchemaBuilder<T>` (type-level only). */
+export type Infer<S> = S extends SchemaBuilder<infer T> ? T : never;
+/** Extract the plain JSONSchema from a builder. */
+export declare function getSchema<T>(builder: SchemaBuilder<T>): JSONSchema<T>;
+export declare function string(): SchemaBuilder<string>;
+export declare function number(): SchemaBuilder<number>;
+export declare function integer(): SchemaBuilder<number>;
+export declare function boolean(): SchemaBuilder<boolean>;
+declare function enumBuilder<T extends string>(...values: readonly T[]): SchemaBuilder<T>;
+declare function enumBuilder<T extends number>(...values: readonly T[]): SchemaBuilder<T>;
+export { enumBuilder as enum };
+export declare function datetime(): SchemaBuilder<string>;
+export declare function date(): SchemaBuilder<string>;
+export declare function time(): SchemaBuilder<string>;
+export declare function duration(): SchemaBuilder<string>;
+export declare function email(): SchemaBuilder<string>;
+export declare function hostname(): SchemaBuilder<string>;
+export declare function ipv4(): SchemaBuilder<string>;
+export declare function ipv6(): SchemaBuilder<string>;
+export declare function uuid(): SchemaBuilder<string>;
+export declare function array<T>(items: SchemaBuilder<T>, options?: {
+    minItems?: 0 | 1;
+}): SchemaBuilder<T[]>;
+export declare function object<P extends Record<string, SchemaBuilder<unknown>>>(properties: P): SchemaBuilder<{
+    [K in keyof P]: Infer<P[K]>;
+}>;
+export declare function anyOf<S extends SchemaBuilder<unknown>[]>(...schemas: S): SchemaBuilder<Infer<S[number]>>;
+export declare function ref(path: string): SchemaBuilder<unknown>;
+export declare const j: {
+    string: typeof string;
+    number: typeof number;
+    integer: typeof integer;
+    boolean: typeof boolean;
+    enum: typeof enumBuilder;
+    datetime: typeof datetime;
+    date: typeof date;
+    time: typeof time;
+    duration: typeof duration;
+    email: typeof email;
+    hostname: typeof hostname;
+    ipv4: typeof ipv4;
+    ipv6: typeof ipv6;
+    uuid: typeof uuid;
+    array: typeof array;
+    object: typeof object;
+    anyOf: typeof anyOf;
+    ref: typeof ref;
+};
+//# sourceMappingURL=schema-builder.d.ts.map

package/dist/alpha/schema-builder.d.ts.map

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

package/dist/alpha/schema-builder.js

@@ -0,0 +1,135 @@
+const SCHEMA = /* @__PURE__ */ Symbol("schema");
+function getSchema(builder) {
+  return builder[SCHEMA];
+}
+function makeBuilder(schema) {
+  return {
+    [SCHEMA]: schema,
+    describe(text) {
+      return makeBuilder({ ...schema, description: text });
+    },
+    nullable() {
+      const { description: desc, ...rest } = schema;
+      const inner = desc !== void 0 ? rest : schema;
+      const wrapper = {
+        anyOf: [inner, { type: "null" }]
+      };
+      if (desc !== void 0) wrapper.description = desc;
+      return makeBuilder(wrapper);
+    }
+  };
+}
+function string() {
+  return makeBuilder({ type: "string" });
+}
+function number() {
+  return makeBuilder({ type: "number" });
+}
+function integer() {
+  return makeBuilder({ type: "integer" });
+}
+function boolean() {
+  return makeBuilder({ type: "boolean" });
+}
+function enumBuilder(...values) {
+  const type = typeof values[0] === "string" ? "string" : "number";
+  return makeBuilder({ type, enum: values });
+}
+function datetime() {
+  return makeBuilder({ type: "string", format: "date-time" });
+}
+function date() {
+  return makeBuilder({ type: "string", format: "date" });
+}
+function time() {
+  return makeBuilder({ type: "string", format: "time" });
+}
+function duration() {
+  return makeBuilder({ type: "string", format: "duration" });
+}
+function email() {
+  return makeBuilder({ type: "string", format: "email" });
+}
+function hostname() {
+  return makeBuilder({ type: "string", format: "hostname" });
+}
+function ipv4() {
+  return makeBuilder({ type: "string", format: "ipv4" });
+}
+function ipv6() {
+  return makeBuilder({ type: "string", format: "ipv6" });
+}
+function uuid() {
+  return makeBuilder({ type: "string", format: "uuid" });
+}
+function array(items, options) {
+  const schema = {
+    type: "array",
+    items: getSchema(items)
+  };
+  if (options?.minItems !== void 0) schema.minItems = options.minItems;
+  return makeBuilder(schema);
+}
+function object(properties) {
+  const schemaProps = {};
+  const keys = Object.keys(properties);
+  for (const key of keys) {
+    schemaProps[key] = getSchema(properties[key]);
+  }
+  return makeBuilder({
+    type: "object",
+    properties: schemaProps,
+    required: keys,
+    additionalProperties: false
+  });
+}
+function anyOf(...schemas) {
+  return makeBuilder({
+    anyOf: schemas.map(getSchema)
+  });
+}
+function ref(path) {
+  return makeBuilder({ $ref: path });
+}
+const j = {
+  string,
+  number,
+  integer,
+  boolean,
+  enum: enumBuilder,
+  datetime,
+  date,
+  time,
+  duration,
+  email,
+  hostname,
+  ipv4,
+  ipv6,
+  uuid,
+  array,
+  object,
+  anyOf,
+  ref
+};
+export {
+  anyOf,
+  array,
+  boolean,
+  date,
+  datetime,
+  duration,
+  email,
+  enumBuilder as enum,
+  getSchema,
+  hostname,
+  integer,
+  ipv4,
+  ipv6,
+  j,
+  number,
+  object,
+  ref,
+  string,
+  time,
+  uuid
+};