@project-ajax/sdk 0.0.66 → 0.0.68

package/dist/builder.d.ts

@@ -1,5 +1,5 @@
 import type { NoticonName } from "./icon-names.js";
-import type { Icon, NoticonColor, PeopleValue, TextValue } from "./types.js";
+import type { Icon, NoticonColor, PeopleValue, PlaceValue, TextValue } from "./types.js";
 /**
  * Creates a rich text value.
  */
@@ -78,6 +78,11 @@ export declare function status(value: string): TextValue;
  * @param emails - Array of email addresses for people to include
  */
 export declare function 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
+ */
+export declare function place(value: PlaceValue): PlaceValue;
 /**
  * Creates an emoji icon.
  * @param emoji - An emoji string (e.g., "🎯", "✨", "🚀")

package/dist/builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAEX,IAAI,EACJ,YAAY,EACZ,WAAW,EACX,SAAS,EACT,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAEnD;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAE1C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAEhD;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAE/C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAE9C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAEpD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAElE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAK/C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CASlD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAYjE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAWvE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,EACb,QAAQ,CAAC,EAAE,MAAM,GACf,SAAS,CAcX;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAEhE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAE/C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAK1D;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAE/C;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,CAEvD;AA4CD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAK7C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACzB,IAAI,EAAE,WAAW,EACjB,KAAK,GAAE,YAAqB,GAC1B,IAAI,CAMN;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAK3C"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAEX,IAAI,EACJ,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAEnD;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAE1C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAEhD;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAE/C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAE9C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAEpD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAElE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAK/C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CASlD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAYjE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAWvE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,EACb,QAAQ,CAAC,EAAE,MAAM,GACf,SAAS,CAcX;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAEhE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAE/C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAK1D;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAE/C;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,CAEvD;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAKnD;AA4CD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAK7C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACzB,IAAI,EAAE,WAAW,EACjB,KAAK,GAAE,YAAqB,GAC1B,IAAI,CAMN;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAK3C"}

package/dist/builder.js

@@ -88,6 +88,12 @@ function status(value) {
 function people(...emails) {
   return emails.map((email2) => ({ email: email2 }));
 }
+function 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;
+}
 function validateDateString(dateString) {
   if (!/^\d{4}-\d{2}-\d{2}$/.test(dateString)) {
     throw new Error(
@@ -148,6 +154,7 @@ export {
   number,
   people,
   phoneNumber,
+  place,
   richText,
   select,
   status,

package/dist/capabilities/oauth.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Configuration for a Notion-managed OAuth provider.
+ *
+ * Notion owns the OAuth app credentials (client ID/secret) and the backend has
+ * pre-configured provider settings.
+ */
+export interface NotionManagedOAuthConfiguration {
+    /**
+     * The unique identifier for this OAuth provider instance.
+     */
+    name: string;
+    /**
+     * The pre-configured provider to use (e.g., "google", "github", "salesforce").
+     * The backend will use this to look up the OAuth configuration.
+     */
+    provider: string;
+    /**
+     * Optional default access token expiry (in milliseconds) to use when the OAuth provider
+     * does not return `expires_in` in token responses.
+     *
+     * Some providers (e.g. Salesforce in certain configurations) may omit expiry information.
+     */
+    accessTokenExpireMs?: number;
+}
+/**
+ * Configuration for a user-managed OAuth provider.
+ *
+ * You own the OAuth app credentials and must explicitly provide endpoints and
+ * other OAuth parameters.
+ */
+export interface UserManagedOAuthConfiguration {
+    /**
+     * The unique identifier for this OAuth provider instance.
+     */
+    name: string;
+    /**
+     * The client ID for the OAuth app.
+     */
+    clientId: string;
+    /**
+     * The client secret for the OAuth app.
+     */
+    clientSecret: string;
+    /**
+     * The OAuth 2.0 authorization endpoint URL.
+     */
+    authorizationEndpoint: string;
+    /**
+     * The OAuth 2.0 token endpoint URL.
+     */
+    tokenEndpoint: string;
+    /**
+     * The OAuth scope(s) to request.
+     */
+    scope: string;
+    /**
+     * Optional additional authorization parameters to include in the authorization request.
+     */
+    authorizationParams?: Record<string, string>;
+    /**
+     * Optional callback URL for OAuth redirect.
+     */
+    callbackUrl?: string;
+    /**
+     * Optional default access token expiry (in milliseconds) to use when the OAuth provider
+     * does not return `expires_in` in token responses.
+     *
+     * Some providers (e.g. Salesforce in certain configurations) may omit expiry information.
+     */
+    accessTokenExpireMs?: number;
+}
+/**
+ * Union type representing either Notion-managed or user-managed OAuth configuration.
+ */
+export type OAuthConfiguration = NotionManagedOAuthConfiguration | UserManagedOAuthConfiguration;
+/**
+ * Creates an OAuth provider configuration for authenticating with third-party services.
+ *
+ * There are two ways to configure OAuth:
+ *
+ * 1. Notion-managed providers:
+ * ```ts
+ * oauth({
+ *   type: "notion_managed",
+ *   name: "my-google-auth",
+ *   provider: "google"
+ * })
+ * ```
+ *
+ * 2. User-managed OAuth configuration:
+ * ```ts
+ * oauth({
+ *   type: "user_managed",
+ *   name: "my-custom-oauth",
+ *   authorizationEndpoint: "https://provider.com/oauth/authorize",
+ *   tokenEndpoint: "https://provider.com/oauth/token",
+ *   scope: "read write",
+ *   clientId: process.env.CLIENT_ID,
+ *   clientSecret: process.env.CLIENT_SECRET,
+ *   authorizationParams: {
+ *     access_type: "offline",
+ *     prompt: "consent"
+ *   }
+ * })
+ * ```
+ *
+ * @param config - The OAuth configuration (Notion-managed or user-managed).
+ * @returns An OAuth provider definition.
+ */
+export declare function oauth(config: OAuthConfiguration): {
+    _tag: string;
+    envKey: string;
+    accessToken(): Promise<string>;
+    config: {
+        type: "notion_managed";
+        name: string;
+        provider: string;
+        accessTokenExpireMs: number | undefined;
+        authorizationEndpoint?: never;
+        tokenEndpoint?: never;
+        scope?: never;
+        clientId?: never;
+        clientSecret?: never;
+        authorizationParams?: never;
+        callbackUrl?: never;
+    };
+} | {
+    _tag: string;
+    envKey: string;
+    accessToken(): Promise<string>;
+    config: {
+        type: "user_managed";
+        name: string;
+        authorizationEndpoint: string;
+        tokenEndpoint: string;
+        scope: string;
+        clientId: string;
+        clientSecret: string;
+        authorizationParams: Record<string, string> | undefined;
+        callbackUrl: string | undefined;
+        accessTokenExpireMs: number | undefined;
+        provider?: never;
+    };
+};
+//# sourceMappingURL=oauth.d.ts.map

package/dist/capabilities/oauth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../../src/capabilities/oauth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,+BAA+B;IAC/C;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,6BAA6B;IAC7C;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7C;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC3B,+BAA+B,GAC/B,6BAA6B,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,kBAAkB;;;mBAOxB,OAAO,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;;mBAehB,OAAO,CAAC,MAAM,CAAC;;;;;;;;;;;;;;EAgBrC"}

package/dist/capabilities/oauth.js

@@ -0,0 +1,53 @@
+function oauth(config) {
+  const envKey = oauthNameToEnvKey(config.name);
+  if ("provider" in config) {
+    return {
+      _tag: "oauth",
+      envKey,
+      async accessToken() {
+        return readRequiredEnvVar(envKey, { name: config.name });
+      },
+      config: {
+        type: "notion_managed",
+        name: config.name,
+        provider: config.provider,
+        accessTokenExpireMs: config.accessTokenExpireMs
+      }
+    };
+  }
+  return {
+    _tag: "oauth",
+    envKey,
+    async accessToken() {
+      return readRequiredEnvVar(envKey, { name: config.name });
+    },
+    config: {
+      type: "user_managed",
+      name: config.name,
+      authorizationEndpoint: config.authorizationEndpoint,
+      tokenEndpoint: config.tokenEndpoint,
+      scope: config.scope,
+      clientId: config.clientId,
+      clientSecret: config.clientSecret,
+      authorizationParams: config.authorizationParams,
+      callbackUrl: config.callbackUrl,
+      accessTokenExpireMs: config.accessTokenExpireMs
+    }
+  };
+}
+function oauthNameToEnvKey(identifier) {
+  const encoded = Buffer.from(identifier).toString("hex").toUpperCase();
+  return `OAUTH_${encoded}_ACCESS_TOKEN`;
+}
+function readRequiredEnvVar(key, context) {
+  const value = process.env[key];
+  if (value) {
+    return value;
+  }
+  throw new Error(
+    `Missing OAuth access token env var "${key}" (name: "${context.name}"). Make sure you've completed OAuth for this capability and are running inside the worker runtime.`
+  );
+}
+export {
+  oauth
+};

package/dist/capabilities/oauth.test.d.ts

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

package/dist/capabilities/oauth.test.d.ts.map

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

package/dist/capabilities/sync.d.ts

@@ -1,11 +1,13 @@
 import type { PropertyConfiguration, PropertySchema, Schema } from "../schema.js";
-import type { Icon, PeopleValue, Schedule, SyncSchedule, TextValue } from "../types.js";
+import type { Icon, PeopleValue, PlaceValue, Schedule, SyncSchedule, TextValue } from "../types.js";
 /**
  * Maps a property configuration to its corresponding value type.
  */
 type PropertyValueType<T extends PropertyConfiguration> = T extends {
     type: "people";
-} ? PeopleValue : TextValue;
+} ? PeopleValue : T extends {
+    type: "place";
+} ? PlaceValue : TextValue;
 /**
  * An object representing a third-party record to be synced.
  */

package/dist/capabilities/sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/capabilities/sync.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,qBAAqB,EACrB,cAAc,EACd,MAAM,EACN,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EACX,IAAI,EACJ,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,SAAS,EAET,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,KAAK,iBAAiB,CAAC,CAAC,SAAS,qBAAqB,IAAI,CAAC,SAAS;IACnE,IAAI,EAAE,QAAQ,CAAC;CACf,GACE,WAAW,GACX,SAAS,CAAC;AAEb;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC,SAAS,cAAc,CAAC,EAAE,CAAC,IAAI;IAC3E,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE;SACV,QAAQ,IAAI,MAAM,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;KACrD,CAAC;IACF;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,OAAO,GAAG,OAAO,IAAI;IACvE;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAEhD;;;;OAIG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,CAC5B,EAAE,SAAS,MAAM,EACjB,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,EACpB,OAAO,GAAG,OAAO,IACd;IACH;;;;OAIG;IACH,kBAAkB,EAAE,EAAE,CAAC;IAEvB;;OAEG;IACH,MAAM,EAAE,CAAC,CAAC;IAEV;;;;;;;;OAQG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;;;;;;;;;;;;OAaG;IACH,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,mBAAmB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;CAC1E,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,OAAO,GAAG,OAAO,IAAI;IACrE,kBAAkB,EAAE,EAAE,CAAC;IACvB,OAAO,EAAE,YAAY,CAAC,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAChD,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,IAAI,CACnB,EAAE,SAAS,MAAM,EACjB,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,EACpB,OAAO,GAAG,OAAO,EAChB,iBAAiB,EAAE,iBAAiB,CAAC,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC;;;;;;;;sBAS5B,OAAO;;;;;EAkBhC"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/capabilities/sync.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,qBAAqB,EACrB,cAAc,EACd,MAAM,EACN,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EACX,IAAI,EACJ,WAAW,EACX,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,SAAS,EAET,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,KAAK,iBAAiB,CAAC,CAAC,SAAS,qBAAqB,IAAI,CAAC,SAAS;IACnE,IAAI,EAAE,QAAQ,CAAC;CACf,GACE,WAAW,GACX,CAAC,SAAS;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B,UAAU,GACV,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC,SAAS,cAAc,CAAC,EAAE,CAAC,IAAI;IAC3E,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE;SACV,QAAQ,IAAI,MAAM,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;KACrD,CAAC;IACF;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,OAAO,GAAG,OAAO,IAAI;IACvE;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAEhD;;;;OAIG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,CAC5B,EAAE,SAAS,MAAM,EACjB,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,EACpB,OAAO,GAAG,OAAO,IACd;IACH;;;;OAIG;IACH,kBAAkB,EAAE,EAAE,CAAC;IAEvB;;OAEG;IACH,MAAM,EAAE,CAAC,CAAC;IAEV;;;;;;;;OAQG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;;;;;;;;;;;;OAaG;IACH,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,mBAAmB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;CAC1E,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,OAAO,GAAG,OAAO,IAAI;IACrE,kBAAkB,EAAE,EAAE,CAAC;IACvB,OAAO,EAAE,YAAY,CAAC,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAChD,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,IAAI,CACnB,EAAE,SAAS,MAAM,EACjB,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,EACpB,OAAO,GAAG,OAAO,EAChB,iBAAiB,EAAE,iBAAiB,CAAC,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC;;;;;;;;sBAS5B,OAAO;;;;;EAkBhC"}

package/dist/index.d.ts

@@ -1,8 +1,10 @@
-export { emojiIcon, imageIcon, notionIcon } from "./builder.js";
+export { emojiIcon, imageIcon, notionIcon, place } from "./builder.js";
 export type { AutomationConfiguration, AutomationContext, PageObjectResponse, } from "./capabilities/automation.js";
 export { automation } from "./capabilities/automation.js";
+export type { NotionManagedOAuthConfiguration, OAuthConfiguration, UserManagedOAuthConfiguration, } from "./capabilities/oauth.js";
+export { oauth } from "./capabilities/oauth.js";
 export type { SyncConfiguration, SyncExecutionResult, SyncedObject, } from "./capabilities/sync.js";
 export { sync } from "./capabilities/sync.js";
 export { tool } from "./capabilities/tool.js";
-export type { Icon, ImageIcon, NoticonColor, NoticonName, Schedule, } from "./types.js";
+export type { Icon, ImageIcon, NoticonColor, NoticonName, PlaceValue, Schedule, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EACX,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,GAClB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,YAAY,EACX,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,GACZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,YAAY,EACX,IAAI,EACJ,SAAS,EACT,YAAY,EACZ,WAAW,EACX,QAAQ,GACR,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACvE,YAAY,EACX,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,GAClB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,YAAY,EACX,+BAA+B,EAC/B,kBAAkB,EAClB,6BAA6B,GAC7B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAChD,YAAY,EACX,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,GACZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,YAAY,EACX,IAAI,EACJ,SAAS,EACT,YAAY,EACZ,WAAW,EACX,UAAU,EACV,QAAQ,GACR,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,5 +1,6 @@
-import { emojiIcon, imageIcon, notionIcon } from "./builder.js";
+import { emojiIcon, imageIcon, notionIcon, place } from "./builder.js";
 import { automation } from "./capabilities/automation.js";
+import { oauth } from "./capabilities/oauth.js";
 import { sync } from "./capabilities/sync.js";
 import { tool } from "./capabilities/tool.js";
 export {
@@ -7,6 +8,8 @@ export {
   emojiIcon,
   imageIcon,
   notionIcon,
+  oauth,
+  place,
   sync,
   tool
 };

package/dist/schema.d.ts

@@ -2,7 +2,7 @@ import type { DateFormat, Icon, NumberFormat, SelectOption, StatusGroup } from "
 /**
  * Supported property types for sync schemas.
  */
-export type PropertyType = "title" | "rich_text" | "url" | "email" | "phone_number" | "checkbox" | "file" | "number" | "date" | "select" | "multi_select" | "status" | "people";
+export type PropertyType = "title" | "rich_text" | "url" | "email" | "phone_number" | "checkbox" | "file" | "number" | "date" | "select" | "multi_select" | "status" | "people" | "place";
 /**
  * Definition of a single property in a sync schema.
  */
@@ -43,9 +43,17 @@ export type PropertyConfiguration = {
     groups: StatusGroup[];
 } | {
     type: "people";
+} | {
+    type: "place";
 };
 export type Schema<PK extends string> = {
-    dataSourceTitle: string;
+    /**
+     * The default name for the database when it is first created.
+     *
+     * Updating this after the database has been created will not change the
+     * name of the database.
+     */
+    defaultName: string;
     /**
      * Optional icon to use as the icon for the database page.
      * If not provided, defaults to 📋.
@@ -116,4 +124,8 @@ export declare function status(config: {
  * Creates a people property definition.
  */
 export declare function people(): PropertyConfiguration;
+/**
+ * Creates a place property definition for storing geographic locations.
+ */
+export declare function place(): PropertyConfiguration;
 //# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

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

package/dist/schema.js

@@ -37,6 +37,9 @@ function status(config) {
 function people() {
   return { type: "people" };
 }
+function place() {
+  return { type: "place" };
+}
 export {
   checkbox,
   date,
@@ -46,6 +49,7 @@ export {
   number,
   people,
   phoneNumber,
+  place,
   richText,
   select,
   status,

package/dist/types.d.ts

@@ -130,6 +130,32 @@ export interface PersonReference {
  */
 export type PeopleValue = PersonReference[];
 export type { NoticonName } from "./icon-names.js";
+/**
+ * Place value representing a geographic location.
+ * Used for place properties in databases.
+ */
+export interface PlaceValue {
+    /**
+     * Latitude coordinate (required)
+     */
+    lat: number;
+    /**
+     * Longitude coordinate (required)
+     */
+    lon: number;
+    /**
+     * Optional display name for the location
+     */
+    name?: string;
+    /**
+     * Optional street address
+     */
+    address?: string;
+    /**
+     * Optional Google Place ID for the location
+     */
+    googlePlaceId?: string;
+}
 /**
  * Time units for schedule intervals.
  * - "m": minutes

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@project-ajax/sdk",
-	"version": "0.0.66",
+	"version": "0.0.68",
 	"description": "An SDK for building workers for the Project Ajax platform",
 	"license": "UNLICENSED",
 	"type": "module",

package/src/builder.ts

@@ -4,6 +4,7 @@ import type {
 	Icon,
 	NoticonColor,
 	PeopleValue,
+	PlaceValue,
 	TextValue,
 } from "./types.js";
 
@@ -187,6 +188,17 @@ export function people(...emails: string[]): PeopleValue {
 	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
+ */
+export function place(value: PlaceValue): PlaceValue {
+	if (typeof value.lat !== "number" || typeof value.lon !== "number") {
+		throw new Error("Place value must have numeric lat and lon coordinates");
+	}
+	return value;
+}
+
 /**
  * Validates a date string is in YYYY-MM-DD format and represents a valid date.
  */

package/src/capabilities/oauth.test.ts

@@ -0,0 +1,51 @@
+import { afterEach, describe, expect, it } from "vitest";
+import { oauth } from "./oauth.js";
+
+describe("oauth", () => {
+	afterEach(() => {
+		// Clean up env changes between tests
+		delete process.env.OAUTH_676F6F676C6541757468_ACCESS_TOKEN;
+		delete process.env.OAUTH_676F6F676C652D63616C656E646172_ACCESS_TOKEN;
+	});
+
+	it("creates notion-managed oauth capability with accessToken helper", async () => {
+		const myOauth = oauth({
+			name: "googleAuth",
+			provider: "google",
+			accessTokenExpireMs: 60_000,
+		});
+
+		expect(myOauth._tag).toBe("oauth");
+		expect(myOauth.config.type).toBe("notion_managed");
+		expect(myOauth.config.accessTokenExpireMs).toBe(60_000);
+		expect(myOauth.envKey).toBe("OAUTH_676F6F676C6541757468_ACCESS_TOKEN");
+		expect(typeof myOauth.accessToken).toBe("function");
+
+		process.env.OAUTH_676F6F676C6541757468_ACCESS_TOKEN = "token-123";
+		await expect(myOauth.accessToken()).resolves.toBe("token-123");
+	});
+
+	it("normalizes non-alphanumeric characters in the identifier", () => {
+		const myOauth = oauth({
+			name: "google-calendar",
+			provider: "google",
+			accessTokenExpireMs: 3600_000,
+		});
+
+		expect(myOauth.envKey).toBe(
+			"OAUTH_676F6F676C652D63616C656E646172_ACCESS_TOKEN",
+		);
+		expect(myOauth.config.accessTokenExpireMs).toBe(3600_000);
+	});
+
+	it("throws a helpful error when the token env var is missing", async () => {
+		const myOauth = oauth({
+			name: "googleAuth",
+			provider: "google",
+		});
+
+		await expect(myOauth.accessToken()).rejects.toThrow(
+			/Missing OAuth access token env var "OAUTH_676F6F676C6541757468_ACCESS_TOKEN"/,
+		);
+	});
+});

package/src/capabilities/oauth.ts

@@ -0,0 +1,181 @@
+/**
+ * Configuration for a Notion-managed OAuth provider.
+ *
+ * Notion owns the OAuth app credentials (client ID/secret) and the backend has
+ * pre-configured provider settings.
+ */
+export interface NotionManagedOAuthConfiguration {
+	/**
+	 * The unique identifier for this OAuth provider instance.
+	 */
+	name: string;
+
+	/**
+	 * The pre-configured provider to use (e.g., "google", "github", "salesforce").
+	 * The backend will use this to look up the OAuth configuration.
+	 */
+	provider: string;
+
+	/**
+	 * Optional default access token expiry (in milliseconds) to use when the OAuth provider
+	 * does not return `expires_in` in token responses.
+	 *
+	 * Some providers (e.g. Salesforce in certain configurations) may omit expiry information.
+	 */
+	accessTokenExpireMs?: number;
+}
+
+/**
+ * Configuration for a user-managed OAuth provider.
+ *
+ * You own the OAuth app credentials and must explicitly provide endpoints and
+ * other OAuth parameters.
+ */
+export interface UserManagedOAuthConfiguration {
+	/**
+	 * The unique identifier for this OAuth provider instance.
+	 */
+	name: string;
+
+	/**
+	 * The client ID for the OAuth app.
+	 */
+	clientId: string;
+
+	/**
+	 * The client secret for the OAuth app.
+	 */
+	clientSecret: string;
+
+	/**
+	 * The OAuth 2.0 authorization endpoint URL.
+	 */
+	authorizationEndpoint: string;
+
+	/**
+	 * The OAuth 2.0 token endpoint URL.
+	 */
+	tokenEndpoint: string;
+
+	/**
+	 * The OAuth scope(s) to request.
+	 */
+	scope: string;
+
+	/**
+	 * Optional additional authorization parameters to include in the authorization request.
+	 */
+	authorizationParams?: Record<string, string>;
+
+	/**
+	 * Optional callback URL for OAuth redirect.
+	 */
+	callbackUrl?: string;
+
+	/**
+	 * Optional default access token expiry (in milliseconds) to use when the OAuth provider
+	 * does not return `expires_in` in token responses.
+	 *
+	 * Some providers (e.g. Salesforce in certain configurations) may omit expiry information.
+	 */
+	accessTokenExpireMs?: number;
+}
+
+/**
+ * Union type representing either Notion-managed or user-managed OAuth configuration.
+ */
+export type OAuthConfiguration =
+	| NotionManagedOAuthConfiguration
+	| UserManagedOAuthConfiguration;
+
+/**
+ * Creates an OAuth provider configuration for authenticating with third-party services.
+ *
+ * There are two ways to configure OAuth:
+ *
+ * 1. Notion-managed providers:
+ * ```ts
+ * oauth({
+ *   type: "notion_managed",
+ *   name: "my-google-auth",
+ *   provider: "google"
+ * })
+ * ```
+ *
+ * 2. User-managed OAuth configuration:
+ * ```ts
+ * oauth({
+ *   type: "user_managed",
+ *   name: "my-custom-oauth",
+ *   authorizationEndpoint: "https://provider.com/oauth/authorize",
+ *   tokenEndpoint: "https://provider.com/oauth/token",
+ *   scope: "read write",
+ *   clientId: process.env.CLIENT_ID,
+ *   clientSecret: process.env.CLIENT_SECRET,
+ *   authorizationParams: {
+ *     access_type: "offline",
+ *     prompt: "consent"
+ *   }
+ * })
+ * ```
+ *
+ * @param config - The OAuth configuration (Notion-managed or user-managed).
+ * @returns An OAuth provider definition.
+ */
+export function oauth(config: OAuthConfiguration) {
+	const envKey = oauthNameToEnvKey(config.name);
+
+	if ("provider" in config) {
+		return {
+			_tag: "oauth",
+			envKey,
+			async accessToken(): Promise<string> {
+				return readRequiredEnvVar(envKey, { name: config.name });
+			},
+			config: {
+				type: "notion_managed" as const,
+				name: config.name,
+				provider: config.provider,
+				accessTokenExpireMs: config.accessTokenExpireMs,
+			},
+		};
+	}
+
+	return {
+		_tag: "oauth",
+		envKey,
+		async accessToken(): Promise<string> {
+			return readRequiredEnvVar(envKey, { name: config.name });
+		},
+		config: {
+			type: "user_managed" as const,
+			name: config.name,
+			authorizationEndpoint: config.authorizationEndpoint,
+			tokenEndpoint: config.tokenEndpoint,
+			scope: config.scope,
+			clientId: config.clientId,
+			clientSecret: config.clientSecret,
+			authorizationParams: config.authorizationParams,
+			callbackUrl: config.callbackUrl,
+			accessTokenExpireMs: config.accessTokenExpireMs,
+		},
+	};
+}
+
+function oauthNameToEnvKey(identifier: string): string {
+	const encoded = Buffer.from(identifier).toString("hex").toUpperCase();
+
+	return `OAUTH_${encoded}_ACCESS_TOKEN`;
+}
+
+function readRequiredEnvVar(key: string, context: { name: string }): string {
+	const value = process.env[key];
+	if (value) {
+		return value;
+	}
+
+	throw new Error(
+		`Missing OAuth access token env var "${key}" (name: "${context.name}"). ` +
+			`Make sure you've completed OAuth for this capability and are running inside the worker runtime.`,
+	);
+}

package/src/capabilities/sync.ts

@@ -7,6 +7,7 @@ import type {
 import type {
 	Icon,
 	PeopleValue,
+	PlaceValue,
 	Schedule,
 	SyncSchedule,
 	TextValue,
@@ -20,7 +21,9 @@ type PropertyValueType<T extends PropertyConfiguration> = T extends {
 	type: "people";
 }
 	? PeopleValue
-	: TextValue;
+	: T extends { type: "place" }
+		? PlaceValue
+		: TextValue;
 
 /**
  * An object representing a third-party record to be synced.

package/src/index.ts

@@ -1,10 +1,16 @@
-export { emojiIcon, imageIcon, notionIcon } from "./builder.js";
+export { emojiIcon, imageIcon, notionIcon, place } from "./builder.js";
 export type {
 	AutomationConfiguration,
 	AutomationContext,
 	PageObjectResponse,
 } from "./capabilities/automation.js";
 export { automation } from "./capabilities/automation.js";
+export type {
+	NotionManagedOAuthConfiguration,
+	OAuthConfiguration,
+	UserManagedOAuthConfiguration,
+} from "./capabilities/oauth.js";
+export { oauth } from "./capabilities/oauth.js";
 export type {
 	SyncConfiguration,
 	SyncExecutionResult,
@@ -17,5 +23,6 @@ export type {
 	ImageIcon,
 	NoticonColor,
 	NoticonName,
+	PlaceValue,
 	Schedule,
 } from "./types.js";

package/src/schema.ts

@@ -22,7 +22,8 @@ export type PropertyType =
 	| "select"
 	| "multi_select"
 	| "status"
-	| "people";
+	| "people"
+	| "place";
 
 /**
  * Definition of a single property in a sync schema.
@@ -62,10 +63,17 @@ export type PropertyConfiguration =
 			type: "status";
 			groups: StatusGroup[];
 	  }
-	| { type: "people" };
+	| { type: "people" }
+	| { type: "place" };
 
 export type Schema<PK extends string> = {
-	dataSourceTitle: string;
+	/**
+	 * The default name for the database when it is first created.
+	 *
+	 * Updating this after the database has been created will not change the
+	 * name of the database.
+	 */
+	defaultName: string;
 	/**
 	 * Optional icon to use as the icon for the database page.
 	 * If not provided, defaults to 📋.
@@ -176,3 +184,10 @@ export function status(config: {
 export function people(): PropertyConfiguration {
 	return { type: "people" };
 }
+
+/**
+ * Creates a place property definition for storing geographic locations.
+ */
+export function place(): PropertyConfiguration {
+	return { type: "place" };
+}

package/src/types.ts

@@ -188,6 +188,33 @@ export type PeopleValue = PersonReference[];
 
 export type { NoticonName } from "./icon-names.js";
 
+/**
+ * Place value representing a geographic location.
+ * Used for place properties in databases.
+ */
+export interface PlaceValue {
+	/**
+	 * Latitude coordinate (required)
+	 */
+	lat: number;
+	/**
+	 * Longitude coordinate (required)
+	 */
+	lon: number;
+	/**
+	 * Optional display name for the location
+	 */
+	name?: string;
+	/**
+	 * Optional street address
+	 */
+	address?: string;
+	/**
+	 * Optional Google Place ID for the location
+	 */
+	googlePlaceId?: string;
+}
+
 /**
  * Time units for schedule intervals.
  * - "m": minutes