@notionhq/workers 0.5.0 → 0.6.0

package/dist/alpha/builder.d.ts

@@ -0,0 +1,149 @@
+import type { NoticonName } from "./icon-names.js";
+import type { Cover, Icon, NoticonColor, PeopleValue, PlaceValue, RelationReference, TextValue } from "./types.js";
+/**
+ * Builders for property values in sync changes.
+ *
+ * @example
+ * ```ts
+ * import { Builder } from "@notionhq/workers/alpha/builder";
+ *
+ * const change = {
+ *   type: "upsert",
+ *   key: "task-1",
+ *   properties: {
+ *     "Task Name": Builder.title("Write docs"),
+ *     Status: Builder.select("Open"),
+ *     Due: Builder.date("2026-08-01"),
+ *     Assignees: Builder.people("alice@example.com"),
+ *   },
+ * };
+ * ```
+ */
+export declare const Builder: {
+    /**
+     * Creates a rich text value.
+     */
+    richText(content: string): TextValue;
+    /**
+     * Creates a URL value.
+     */
+    url(url: string): TextValue;
+    /**
+     * Creates a title value.
+     */
+    title(content: string): TextValue;
+    /**
+     * Creates a text value.
+     */
+    text(content: string): TextValue;
+    /**
+     * Creates an email value.
+     */
+    email(email: string): TextValue;
+    /**
+     * Creates a phone number value.
+     */
+    phoneNumber(phone: string): TextValue;
+    /**
+     * Creates a checkbox value.
+     */
+    checkbox(checked: boolean): TextValue;
+    /**
+     * Creates a file URL value.
+     * @param fileUrl - The URL of the file
+     * @param fileName - Optional display name for the file (defaults to URL)
+     */
+    file(fileUrl: string, fileName?: string): TextValue;
+    /**
+     * Creates a number value.
+     */
+    number(value: number): TextValue;
+    /**
+     * Creates a date value from a date string (YYYY-MM-DD).
+     */
+    date(dateString: string): TextValue;
+    /**
+     * Creates a datetime value from an ISO 8601 datetime string.
+     * @param isoString - An ISO 8601 datetime string (e.g., "2024-01-15T10:30", "2024-01-15T10:30:00Z")
+     * @param timeZone - Optional IANA timezone name (e.g., "America/New_York")
+     */
+    dateTime(isoString: string, timeZone?: string): TextValue;
+    /**
+     * Creates a date range value from date strings.
+     */
+    dateRange(startDate: string, endDate: string): TextValue;
+    /**
+     * Creates a datetime range value from ISO 8601 datetime strings.
+     * @param startDateTime - An ISO 8601 datetime string for the range start
+     * @param endDateTime - An ISO 8601 datetime string for the range end
+     * @param timeZone - Optional IANA timezone name (e.g., "America/New_York")
+     */
+    dateTimeRange(startDateTime: string, endDateTime: string, timeZone?: string): TextValue;
+    /**
+     * Creates a link with custom display text.
+     * @param displayText - The text to display
+     * @param url - The URL to link to
+     */
+    link(displayText: string, url: string): TextValue;
+    /**
+     * Creates a select value from a single option.
+     */
+    select(value: string): TextValue;
+    /**
+     * Creates a multi-select value from multiple options.
+     * @param values - Array of option names to select
+     */
+    multiSelect(...values: string[]): TextValue;
+    /**
+     * Creates a status value from a status option name.
+     */
+    status(value: string): TextValue;
+    /**
+     * Creates a people value from email addresses.
+     * @param emails - Array of email addresses for people to include
+     */
+    people(...emails: string[]): PeopleValue;
+    /**
+     * Creates a place value for a geographic location.
+     * @param value - The place value with lat/lon coordinates and optional name/address
+     */
+    place(value: PlaceValue): PlaceValue;
+    /**
+     * Creates a relation reference from a primary key of a related record.
+     * Use an array of relation references as the property value.
+     *
+     * @param primaryKey - The primary key of the related record
+     * @example
+     * ```typescript
+     * // Single relation
+     * { Project: [Builder.relation("project-123")] }
+     *
+     * // Multiple relations
+     * { Projects: [Builder.relation("project-123"), Builder.relation("project-456")] }
+     * ```
+     */
+    relation(primaryKey: string): RelationReference;
+    /**
+     * Creates an emoji icon.
+     * @param emoji - An emoji string (e.g., "🎯", "✨", "🚀")
+     */
+    emojiIcon(emoji: string): Icon;
+    /**
+     * Creates a Notion icon with a specific color.
+     * @param icon - The name of the Notion icon (e.g., "checkmark", "pizza", "rocket")
+     * @param color - The color variant (defaults to "gray")
+     */
+    notionIcon(icon: NoticonName, color?: NoticonColor): Icon;
+    /**
+     * Creates an image icon from an external URL.
+     * @param url - The URL of the image (e.g., "https://example.com/icon.png")
+     */
+    imageIcon(url: string): Icon;
+    /**
+     * Creates an image cover from an external URL.
+     * @param url - The URL of the image (e.g., "https://example.com/cover.png")
+     * @param position - Vertical image position, from 0 (top) to 1 (bottom). Defaults to 0.5.
+     */
+    imageCover(url: string, position?: number): Cover;
+};
+//# sourceMappingURL=builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/alpha/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EACX,KAAK,EAEL,IAAI,EACJ,YAAY,EACZ,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,SAAS,EACT,MAAM,YAAY,CAAC;AA6CpB;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,OAAO;IACnB;;OAEG;sBACe,MAAM,GAAG,SAAS;IAIpC;;OAEG;aACM,MAAM,GAAG,SAAS;IAI3B;;OAEG;mBACY,MAAM,GAAG,SAAS;IAIjC;;OAEG;kBACW,MAAM,GAAG,SAAS;IAIhC;;OAEG;iBACU,MAAM,GAAG,SAAS;IAI/B;;OAEG;uBACgB,MAAM,GAAG,SAAS;IAIrC;;OAEG;sBACe,OAAO,GAAG,SAAS;IAIrC;;;;OAIG;kBACW,MAAM,aAAa,MAAM,GAAG,SAAS;IAInD;;OAEG;kBACW,MAAM,GAAG,SAAS;IAOhC;;OAEG;qBACc,MAAM,GAAG,SAAS;IASnC;;;;OAIG;wBACiB,MAAM,aAAa,MAAM,GAAG,SAAS;IAgBzD;;OAEG;yBACkB,MAAM,WAAW,MAAM,GAAG,SAAS;IAWxD;;;;;OAKG;iCAC0B,MAAM,eAAe,MAAM,aAAa,MAAM,GAAG,SAAS;IAmBvF;;;;OAIG;sBACe,MAAM,OAAO,MAAM,GAAG,SAAS;IAIjD;;OAEG;kBACW,MAAM,GAAG,SAAS;IAIhC;;;OAGG;2BACoB,MAAM,EAAE,GAAG,SAAS;IAO3C;;OAEG;kBACW,MAAM,GAAG,SAAS;IAIhC;;;OAGG;sBACe,MAAM,EAAE,GAAG,WAAW;IAIxC;;;OAGG;iBACU,UAAU,GAAG,UAAU;IAOpC;;;;;;;;;;;;;OAaG;yBACkB,MAAM,GAAG,iBAAiB;IAI/C;;;OAGG;qBACc,MAAM,GAAG,IAAI;IAO9B;;;;OAIG;qBACc,WAAW,UAAS,YAAY,GAAY,IAAI;IAQjE;;;OAGG;mBACY,MAAM,GAAG,IAAI;IAO5B;;;;OAIG;oBACa,MAAM,sBAAmB,KAAK;CAW9C,CAAC"}

package/dist/alpha/builder.js

@@ -0,0 +1,260 @@
+function validateDateString(dateString) {
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(dateString)) {
+    throw new Error(`Invalid date format: ${dateString}. Expected YYYY-MM-DD format.`);
+  }
+  const date = new Date(dateString);
+  if (Number.isNaN(date.getTime())) {
+    throw new Error(`Invalid date: ${dateString}`);
+  }
+}
+function createDateToken(dateValue) {
+  return [["\u2023", [["d", dateValue]]]];
+}
+function parseISODateTime(isoString) {
+  if (!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}/.test(isoString)) {
+    throw new Error(
+      `Invalid ISO 8601 datetime: ${isoString}. Expected format like 2024-01-15T10:30 or 2024-01-15T10:30:00Z`
+    );
+  }
+  const date = isoString.slice(0, 10);
+  const time = isoString.slice(11, 16);
+  if (Number.isNaN(new Date(isoString).getTime())) {
+    throw new Error(`Invalid datetime: ${isoString}`);
+  }
+  return { date, time };
+}
+const Builder = {
+  /**
+   * Creates a rich text value.
+   */
+  richText(content) {
+    return [[content]];
+  },
+  /**
+   * Creates a URL value.
+   */
+  url(url) {
+    return [[url]];
+  },
+  /**
+   * Creates a title value.
+   */
+  title(content) {
+    return [[content]];
+  },
+  /**
+   * Creates a text value.
+   */
+  text(content) {
+    return [[content]];
+  },
+  /**
+   * Creates an email value.
+   */
+  email(email) {
+    return [[email]];
+  },
+  /**
+   * Creates a phone number value.
+   */
+  phoneNumber(phone) {
+    return [[phone]];
+  },
+  /**
+   * Creates a checkbox value.
+   */
+  checkbox(checked) {
+    return checked ? [["Yes"]] : [["No"]];
+  },
+  /**
+   * Creates a file URL value.
+   * @param fileUrl - The URL of the file
+   * @param fileName - Optional display name for the file (defaults to URL)
+   */
+  file(fileUrl, fileName) {
+    return [[fileName ?? fileUrl, [["a", fileUrl]]]];
+  },
+  /**
+   * Creates a number value.
+   */
+  number(value) {
+    if (Number.isNaN(value)) {
+      return [];
+    }
+    return [[value.toString()]];
+  },
+  /**
+   * Creates a date value from a date string (YYYY-MM-DD).
+   */
+  date(dateString) {
+    validateDateString(dateString);
+    return createDateToken({
+      type: "date",
+      start_date: dateString
+    });
+  },
+  /**
+   * Creates a datetime value from an ISO 8601 datetime string.
+   * @param isoString - An ISO 8601 datetime string (e.g., "2024-01-15T10:30", "2024-01-15T10:30:00Z")
+   * @param timeZone - Optional IANA timezone name (e.g., "America/New_York")
+   */
+  dateTime(isoString, timeZone) {
+    const { date, time } = parseISODateTime(isoString);
+    const dateValue = {
+      type: "datetime",
+      start_date: date,
+      start_time: time
+    };
+    if (timeZone) {
+      dateValue.time_zone = timeZone;
+    }
+    return createDateToken(dateValue);
+  },
+  /**
+   * Creates a date range value from date strings.
+   */
+  dateRange(startDate, endDate) {
+    validateDateString(startDate);
+    validateDateString(endDate);
+    return createDateToken({
+      type: "daterange",
+      start_date: startDate,
+      end_date: endDate
+    });
+  },
+  /**
+   * Creates a datetime range value from ISO 8601 datetime strings.
+   * @param startDateTime - An ISO 8601 datetime string for the range start
+   * @param endDateTime - An ISO 8601 datetime string for the range end
+   * @param timeZone - Optional IANA timezone name (e.g., "America/New_York")
+   */
+  dateTimeRange(startDateTime, endDateTime, timeZone) {
+    const start = parseISODateTime(startDateTime);
+    const end = parseISODateTime(endDateTime);
+    const dateValue = {
+      type: "datetimerange",
+      start_date: start.date,
+      start_time: start.time,
+      end_date: end.date,
+      end_time: end.time
+    };
+    if (timeZone) {
+      dateValue.time_zone = timeZone;
+    }
+    return createDateToken(dateValue);
+  },
+  /**
+   * Creates a link with custom display text.
+   * @param displayText - The text to display
+   * @param url - The URL to link to
+   */
+  link(displayText, url) {
+    return [[displayText, [["a", url]]]];
+  },
+  /**
+   * Creates a select value from a single option.
+   */
+  select(value) {
+    return [[value]];
+  },
+  /**
+   * Creates a multi-select value from multiple options.
+   * @param values - Array of option names to select
+   */
+  multiSelect(...values) {
+    if (values.length === 0) {
+      return [];
+    }
+    return [[values.join(",")]];
+  },
+  /**
+   * Creates a status value from a status option name.
+   */
+  status(value) {
+    return [[value]];
+  },
+  /**
+   * Creates a people value from email addresses.
+   * @param emails - Array of email addresses for people to include
+   */
+  people(...emails) {
+    return emails.map((email) => ({ email }));
+  },
+  /**
+   * Creates a place value for a geographic location.
+   * @param value - The place value with lat/lon coordinates and optional name/address
+   */
+  place(value) {
+    if (typeof value.lat !== "number" || typeof value.lon !== "number") {
+      throw new Error("Place value must have numeric lat and lon coordinates");
+    }
+    return value;
+  },
+  /**
+   * Creates a relation reference from a primary key of a related record.
+   * Use an array of relation references as the property value.
+   *
+   * @param primaryKey - The primary key of the related record
+   * @example
+   * ```typescript
+   * // Single relation
+   * { Project: [Builder.relation("project-123")] }
+   *
+   * // Multiple relations
+   * { Projects: [Builder.relation("project-123"), Builder.relation("project-456")] }
+   * ```
+   */
+  relation(primaryKey) {
+    return { type: "primaryKey", value: primaryKey };
+  },
+  /**
+   * Creates an emoji icon.
+   * @param emoji - An emoji string (e.g., "🎯", "✨", "🚀")
+   */
+  emojiIcon(emoji) {
+    return {
+      type: "emoji",
+      value: emoji
+    };
+  },
+  /**
+   * Creates a Notion icon with a specific color.
+   * @param icon - The name of the Notion icon (e.g., "checkmark", "pizza", "rocket")
+   * @param color - The color variant (defaults to "gray")
+   */
+  notionIcon(icon, color = "gray") {
+    return {
+      type: "notion",
+      icon,
+      color
+    };
+  },
+  /**
+   * Creates an image icon from an external URL.
+   * @param url - The URL of the image (e.g., "https://example.com/icon.png")
+   */
+  imageIcon(url) {
+    return {
+      type: "image",
+      url
+    };
+  },
+  /**
+   * Creates an image cover from an external URL.
+   * @param url - The URL of the image (e.g., "https://example.com/cover.png")
+   * @param position - Vertical image position, from 0 (top) to 1 (bottom). Defaults to 0.5.
+   */
+  imageCover(url, position = 0.5) {
+    if (!Number.isFinite(position) || position < 0 || position > 1) {
+      throw new Error(`Invalid cover position: ${position}. Expected a number between 0 and 1.`);
+    }
+    return {
+      type: "image",
+      url,
+      position
+    };
+  }
+};
+export {
+  Builder
+};

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

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

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

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

package/dist/alpha/cli/build.d.ts

@@ -0,0 +1,13 @@
+import type { WorkerManifest } from "../manifest.js";
+export type BuildResult = {
+    manifest: WorkerManifest;
+    bundlePath: string;
+    manifestPath: string;
+};
+/**
+ * Build a worker project: discover capability files by convention, generate
+ * the entry module, bundle it into a single `dist/worker.js`, and emit
+ * `dist/manifest.json` describing every capability.
+ */
+export declare function buildWorker(projectRoot: string): Promise<BuildResult>;
+//# sourceMappingURL=build.d.ts.map

package/dist/alpha/cli/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/alpha/cli/build.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAKrD,MAAM,MAAM,WAAW,GAAG;IACzB,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAmC3E"}

package/dist/alpha/cli/build.js

@@ -0,0 +1,36 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { rolldown } from "rolldown";
+import { generateEntry } from "./codegen.js";
+import { discoverCapabilities } from "./discover.js";
+import { extractManifest } from "./emit-manifest.js";
+async function buildWorker(projectRoot) {
+  const capabilities = await discoverCapabilities(projectRoot);
+  if (capabilities.length === 0) {
+    throw new Error(
+      `No capabilities found in ${projectRoot}. Add capability files by convention, e.g. src/syncs/<name>.ts default-exporting createSync(...).`
+    );
+  }
+  const entryPath = path.join(projectRoot, ".notion", "entry.ts");
+  await fs.promises.mkdir(path.dirname(entryPath), { recursive: true });
+  await fs.promises.writeFile(entryPath, generateEntry(capabilities));
+  const bundlePath = path.join(projectRoot, "dist", "worker.js");
+  const bundle = await rolldown({
+    input: entryPath,
+    platform: "node",
+    external: (id) => !id.startsWith(".") && !path.isAbsolute(id)
+  });
+  try {
+    await bundle.write({ format: "esm", file: bundlePath });
+  } finally {
+    await bundle.close();
+  }
+  const manifest = await extractManifest(bundlePath, capabilities);
+  const manifestPath = path.join(projectRoot, "dist", "manifest.json");
+  await fs.promises.writeFile(manifestPath, `${JSON.stringify(manifest, null, "	")}
+`);
+  return { manifest, bundlePath, manifestPath };
+}
+export {
+  buildWorker
+};

package/dist/alpha/cli/build.test.d.ts

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

package/dist/alpha/cli/build.test.d.ts.map

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

package/dist/alpha/cli/codegen.d.ts

@@ -0,0 +1,10 @@
+import type { DiscoveredCapability } from "./discover.js";
+/**
+ * Generate the worker entry module for a set of discovered capabilities.
+ *
+ * The module uses only static imports so that the bundler can bundle the
+ * whole worker into a single file. It is written to `.notion/entry.ts` in
+ * the worker project, so imports are relative to that location.
+ */
+export declare function generateEntry(capabilities: readonly DiscoveredCapability[]): string;
+//# sourceMappingURL=codegen.d.ts.map

package/dist/alpha/cli/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../../src/alpha/cli/codegen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1D;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,SAAS,oBAAoB,EAAE,GAAG,MAAM,CAyCnF"}

package/dist/alpha/cli/codegen.js

@@ -0,0 +1,41 @@
+function generateEntry(capabilities) {
+  const imports = [];
+  const registryEntries = /* @__PURE__ */ new Map();
+  capabilities.forEach((capability, index) => {
+    const binding = `capability_${index}`;
+    imports.push(`import ${binding} from ${JSON.stringify(`../${capability.sourcePath}`)};`);
+    const entries = registryEntries.get(capability.type) ?? [];
+    entries.push(`		${JSON.stringify(capability.key)}: ${binding},`);
+    registryEntries.set(capability.type, entries);
+  });
+  const registry = Array.from(registryEntries.entries()).map(([type, entries]) => `	${JSON.stringify(type)}: {
+${entries.join("\n")}
+	},`).join("\n");
+  return `// Generated by \`notion-workers build\`. Do not edit.
+${imports.join("\n")}
+
+type Handler = (context?: unknown, options?: { concreteOutput?: true }) => Promise<unknown>;
+
+export const capabilities: Record<string, Record<string, { handler: Handler }>> = {
+${registry}
+};
+
+export async function run(
+	type: string,
+	key: string,
+	context?: unknown,
+	options?: { concreteOutput?: true },
+): Promise<unknown> {
+	const capability = capabilities[type]?.[key];
+
+	if (!capability) {
+		throw new Error(\`Capability "\${type}/\${key}" not found\`);
+	}
+
+	return capability.handler(context, options);
+}
+`;
+}
+export {
+  generateEntry
+};

package/dist/alpha/cli/codegen.test.d.ts

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

package/dist/alpha/cli/codegen.test.d.ts.map

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

package/dist/alpha/cli/discover.d.ts

@@ -0,0 +1,35 @@
+import type { CapabilityType } from "../manifest.js";
+/**
+ * A capability type the build tool knows how to discover: which directory
+ * under `src/` its files live in, and the `_tag` its default exports must
+ * carry. Adding a new capability type to the SDK means adding an entry here
+ * (plus its factory function).
+ */
+export type CapabilityTypeDefinition = {
+    type: CapabilityType;
+    directory: string;
+    tag: string;
+};
+export declare const CAPABILITY_TYPES: readonly CapabilityTypeDefinition[];
+/**
+ * A capability file found during discovery. The key is the file's basename;
+ * combined with the type it forms the capability's identity (`sync/static`).
+ */
+export type DiscoveredCapability = {
+    type: CapabilityType;
+    tag: string;
+    key: string;
+    /** Path to the source file, relative to the project root. */
+    sourcePath: string;
+};
+/**
+ * Discover capability files by convention: every `.ts` file directly under
+ * `src/<directory>/` for each registered capability type. Subdirectories are
+ * not searched — they hold plain modules, not capabilities.
+ *
+ * Only capabilities are discovered by file location. Resources (databases,
+ * pacers) live anywhere and are discovered by walking capability configs at
+ * manifest time.
+ */
+export declare function discoverCapabilities(projectRoot: string, capabilityTypes?: readonly CapabilityTypeDefinition[]): Promise<DiscoveredCapability[]>;
+//# sourceMappingURL=discover.d.ts.map

package/dist/alpha/cli/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../../src/alpha/cli/discover.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,SAAS,wBAAwB,EAI/D,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACzC,WAAW,EAAE,MAAM,EACnB,eAAe,GAAE,SAAS,wBAAwB,EAAqB,GACrE,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAiCjC"}

package/dist/alpha/cli/discover.js

@@ -0,0 +1,39 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+const CAPABILITY_TYPES = [
+  { type: "sync", directory: "syncs", tag: "sync" },
+  { type: "tool", directory: "tools", tag: "tool" },
+  { type: "workflow", directory: "workflows", tag: "workflow" }
+];
+async function discoverCapabilities(projectRoot, capabilityTypes = CAPABILITY_TYPES) {
+  const discovered = [];
+  for (const definition of capabilityTypes) {
+    const directory = path.join(projectRoot, "src", definition.directory);
+    let entries;
+    try {
+      entries = await fs.promises.readdir(directory, { withFileTypes: true });
+    } catch (error) {
+      if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+        continue;
+      }
+      throw error;
+    }
+    entries.sort((a, b) => a.name.localeCompare(b.name));
+    for (const entry of entries) {
+      if (!entry.isFile() || !entry.name.endsWith(".ts") || entry.name.endsWith(".d.ts")) {
+        continue;
+      }
+      discovered.push({
+        type: definition.type,
+        tag: definition.tag,
+        key: entry.name.slice(0, -".ts".length),
+        sourcePath: path.join("src", definition.directory, entry.name)
+      });
+    }
+  }
+  return discovered;
+}
+export {
+  CAPABILITY_TYPES,
+  discoverCapabilities
+};

package/dist/alpha/cli/discover.test.d.ts

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

package/dist/alpha/cli/discover.test.d.ts.map

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

package/dist/alpha/cli/emit-manifest.d.ts

@@ -0,0 +1,33 @@
+import type { WorkerManifest } from "../manifest.js";
+import type { DiscoveredCapability } from "./discover.js";
+/**
+ * Extract the worker manifest from a built bundle.
+ *
+ * This is the one place the build executes worker code: the bundle is
+ * imported once (running module top-level code only — handlers are never
+ * invoked), each discovered capability's default export is validated
+ * against the tag its directory requires, and the handler-free configs are
+ * assembled into the manifest.
+ *
+ * Resources are not discovered from the filesystem. Databases are collected
+ * by walking capability configs — a sync's `database`, and transitively any
+ * database referenced by a schema's `relation` properties. Pacers register
+ * themselves when created, so importing the bundle populates the pacer
+ * registry as a side effect. Within a build, resources deduplicate by
+ * object identity; across deploys their `name` is the stable key. Two
+ * distinct resource objects sharing a name fail the build.
+ */
+export declare function extractManifest(bundlePath: string, capabilities: readonly DiscoveredCapability[]): Promise<WorkerManifest>;
+/**
+ * Throw if `value` contains anything `JSON.stringify` would silently drop or
+ * rewrite, so a config that can't round-trip fails the build here rather than
+ * producing a manifest that quietly disagrees with the author's source.
+ *
+ * Rejects functions, symbols, bigints, non-finite numbers, `undefined` array
+ * elements, and non-plain objects (Map, Set, Date, class instances). Allows
+ * null, booleans, finite numbers, strings, plain arrays, and plain objects.
+ * `undefined`-valued object properties are permitted and omitted, mirroring
+ * JSON semantics for unset optional fields.
+ */
+export declare function assertJsonSafe(value: unknown, path: string): void;
+//# sourceMappingURL=emit-manifest.d.ts.map

package/dist/alpha/cli/emit-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-manifest.d.ts","sourceRoot":"","sources":["../../../src/alpha/cli/emit-manifest.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAA6C,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAuJ1D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,eAAe,CACpC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,SAAS,oBAAoB,EAAE,GAC3C,OAAO,CAAC,cAAc,CAAC,CAoEzB;AA2GD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CA4CjE"}