@hexclave/js 1.0.0

package/dist/esm/lib/stack-app/teams/index.d.ts

@@ -0,0 +1,160 @@
+import { ReadonlyJson } from "@hexclave/shared/dist/utils/json";
+import { TeamsCrud } from "@hexclave/shared/dist/interface/crud/teams";
+import { AsyncStoreProperty } from "../common";
+import { ApiKeyCreationOptions, TeamApiKey, TeamApiKeyFirstView } from "../api-keys";
+import { Customer } from "../customers";
+import { ServerUser } from "../users";
+
+//#region src/lib/stack-app/teams/index.d.ts
+type TeamMemberProfile = {
+  displayName: string | null;
+  profileImageUrl: string | null;
+};
+type TeamMemberProfileUpdateOptions = {
+  displayName?: string;
+  profileImageUrl?: string | null;
+};
+type EditableTeamMemberProfile = TeamMemberProfile & {
+  update(update: TeamMemberProfileUpdateOptions): Promise<void>;
+};
+type TeamUser = {
+  id: string;
+  teamProfile: TeamMemberProfile;
+};
+/**
+ * A team invitation as seen from the team's perspective (ie. the sender).
+ *
+ * Returned by `team.listInvitations()`. Contains the recipient email and allows
+ * revoking the invitation.
+ */
+type SentTeamInvitation = {
+  id: string;
+  recipientEmail: string | null;
+  expiresAt: Date;
+  revoke(): Promise<void>;
+};
+/**
+ * @deprecated Use `SentTeamInvitation` instead.
+ */
+type TeamInvitation = SentTeamInvitation;
+/**
+ * A team invitation as seen from the invited user's perspective (ie. the receiver).
+ *
+ * Returned by `user.listTeamInvitations()`. Contains information about teams that have
+ * sent invitations to any of the user's verified email addresses, and allows accepting
+ * the invitation to join the team.
+ */
+type ReceivedTeamInvitation = {
+  id: string;
+  teamId: string;
+  teamDisplayName: string;
+  recipientEmail: string;
+  expiresAt: Date;
+  /**
+   * Accepts the invitation, adding the current user to the team.
+   *
+   * The user must have a verified email address matching the invitation's recipient email.
+   */
+  accept(): Promise<void>;
+};
+type Team = {
+  id: string;
+  displayName: string;
+  profileImageUrl: string | null;
+  clientMetadata: any;
+  clientReadOnlyMetadata: any;
+  inviteUser(options: {
+    email: string;
+    callbackUrl?: string;
+  }): Promise<void>;
+  listUsers(): Promise<TeamUser[]>;
+  listInvitations(): Promise<SentTeamInvitation[]>;
+  update(update: TeamUpdateOptions): Promise<void>;
+  delete(): Promise<void>;
+  createApiKey(options: ApiKeyCreationOptions<"team">): Promise<TeamApiKeyFirstView>;
+} & AsyncStoreProperty<"apiKeys", [], TeamApiKey[], true> & Customer;
+type TeamUpdateOptions = {
+  displayName?: string;
+  profileImageUrl?: string | null;
+  clientMetadata?: ReadonlyJson;
+};
+declare function teamUpdateOptionsToCrud(options: TeamUpdateOptions): TeamsCrud["Client"]["Update"];
+type TeamCreateOptions = {
+  displayName: string;
+  profileImageUrl?: string;
+};
+declare function teamCreateOptionsToCrud(options: TeamCreateOptions, creatorUserId: string): TeamsCrud["Client"]["Create"];
+type ServerTeamMemberProfile = TeamMemberProfile;
+type ServerTeamUser = ServerUser & {
+  teamProfile: ServerTeamMemberProfile;
+};
+type ServerTeam = {
+  createdAt: Date;
+  serverMetadata: any;
+  listUsers(): Promise<ServerTeamUser[]>;
+  update(update: ServerTeamUpdateOptions): Promise<void>;
+  delete(): Promise<void>;
+  addUser(userId: string): Promise<void>;
+  inviteUser(options: {
+    email: string;
+    callbackUrl?: string;
+  }): Promise<void>;
+  removeUser(userId: string): Promise<void>;
+} & Team;
+type ServerListUsersOptionsBase = {
+  cursor?: string;
+  limit?: number;
+  orderBy?: 'signedUpAt' | 'lastActiveAt';
+  desc?: boolean;
+  /**
+   * Free-text search. Matches user ID (exact UUID), display name, and contact channels (e.g. primary email).
+   */
+  query?: string;
+  /**
+   * Only return users who are members of the given team.
+   */
+  teamId?: string;
+  /**
+   * Whether to include restricted users (users who haven't completed onboarding requirements).
+   * Defaults to false.
+   */
+  includeRestricted?: boolean;
+  /**
+   * Whether to include anonymous users (and restricted users).
+   * Defaults to false.
+   */
+  includeAnonymous?: boolean;
+};
+type ServerListUsersOptions = ServerListUsersOptionsBase & ({
+  onlyAnonymous?: false;
+} | {
+  /**
+   * Whether to return only anonymous users.
+   * Requires includeAnonymous=true.
+   * Defaults to false.
+   */
+  onlyAnonymous: true;
+  includeAnonymous: true;
+});
+type ServerListTeamsOptions = {
+  orderBy?: 'createdAt';
+  desc?: boolean;
+  cursor?: string;
+  limit?: number;
+  /**
+   * Free-text search. Matches team ID (exact UUID) and display name.
+   */
+  query?: string;
+};
+type ServerTeamCreateOptions = TeamCreateOptions & {
+  creatorUserId?: string;
+};
+declare function serverTeamCreateOptionsToCrud(options: ServerTeamCreateOptions): TeamsCrud["Server"]["Create"];
+type ServerTeamUpdateOptions = TeamUpdateOptions & {
+  clientReadOnlyMetadata?: ReadonlyJson;
+  serverMetadata?: ReadonlyJson;
+};
+declare function serverTeamUpdateOptionsToCrud(options: ServerTeamUpdateOptions): TeamsCrud["Server"]["Update"];
+//#endregion
+export { EditableTeamMemberProfile, ReceivedTeamInvitation, SentTeamInvitation, ServerListTeamsOptions, ServerListUsersOptions, ServerTeam, ServerTeamCreateOptions, ServerTeamMemberProfile, ServerTeamUpdateOptions, ServerTeamUser, Team, TeamCreateOptions, TeamInvitation, TeamMemberProfile, TeamMemberProfileUpdateOptions, TeamUpdateOptions, TeamUser, serverTeamCreateOptionsToCrud, serverTeamUpdateOptionsToCrud, teamCreateOptionsToCrud, teamUpdateOptionsToCrud };
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/lib/stack-app/teams/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../../../src/lib/stack-app/teams/index.ts"],"mappings":";;;;;;;;KAaY,iBAAA;EACV,WAAA;EACA,eAAA;AAAA;AAAA,KAGU,8BAAA;EACV,WAAA;EACA,eAAA;AAAA;AAAA,KAGU,yBAAA,GAA4B,iBAAA;EACtC,MAAA,CAAO,MAAA,EAAQ,8BAAA,GAAiC,OAAA;AAAA;AAAA,KAGtC,QAAA;EACV,EAAA;EACA,WAAA,EAAa,iBAAA;AAAA;;;;;;;KASH,kBAAA;EACV,EAAA;EACA,cAAA;EACA,SAAA,EAAW,IAAA;EACX,MAAA,IAAU,OAAA;AAAA;AAfZ;;;AAAA,KAqBY,cAAA,GAAiB,kBAAA;;;;;;AAV7B;;KAmBY,sBAAA;EACV,EAAA;EACA,MAAA;EACA,eAAA;EACA,cAAA;EACA,SAAA,EAAW,IAAA;EApBX;;;;AAMF;EAqBE,MAAA,IAAU,OAAA;AAAA;AAAA,KAGA,IAAA;EACV,EAAA;EACA,WAAA;EACA,eAAA;EACA,cAAA;EACA,sBAAA;EACA,UAAA,CAAW,OAAA;IAAW,KAAA;IAAe,WAAA;EAAA,IAAyB,OAAA;EAC9D,SAAA,IAAa,OAAA,CAAQ,QAAA;EACrB,eAAA,IAAmB,OAAA,CAAQ,kBAAA;EAC3B,MAAA,CAAO,MAAA,EAAQ,iBAAA,GAAoB,OAAA;EACnC,MAAA,IAAU,OAAA;EACV,YAAA,CAAa,OAAA,EAAS,qBAAA,WAAgC,OAAA,CAAQ,mBAAA;AAAA,IAC5D,kBAAA,gBAAkC,UAAA,YAAsB,QAAA;AAAA,KAEhD,iBAAA;EACV,WAAA;EACA,eAAA;EACA,cAAA,GAAiB,YAAA;AAAA;AAAA,iBAEH,uBAAA,CAAwB,OAAA,EAAS,iBAAA,GAAoB,SAAA;AAAA,KAQzD,iBAAA;EACV,WAAA;EACA,eAAA;AAAA;AAAA,iBAEc,uBAAA,CAAwB,OAAA,EAAS,iBAAA,EAAmB,aAAA,WAAwB,SAAA;AAAA,KAShF,uBAAA,GAA0B,iBAAA;AAAA,KAE1B,cAAA,GAAiB,UAAA;EAC3B,WAAA,EAAa,uBAAA;AAAA;AAAA,KAGH,UAAA;EACV,SAAA,EAAW,IAAA;EACX,cAAA;EACA,SAAA,IAAa,OAAA,CAAQ,cAAA;EACrB,MAAA,CAAO,MAAA,EAAQ,uBAAA,GAA0B,OAAA;EACzC,MAAA,IAAU,OAAA;EACV,OAAA,CAAQ,MAAA,WAAiB,OAAA;EACzB,UAAA,CAAW,OAAA;IAAW,KAAA;IAAe,WAAA;EAAA,IAAyB,OAAA;EAC9D,UAAA,CAAW,MAAA,WAAiB,OAAA;AAAA,IAC1B,IAAA;AAAA,KAEC,0BAAA;EACH,MAAA;EACA,KAAA;EACA,OAAA;EACA,IAAA;EArDmB;;;EAyDnB,KAAA;EAxDO;;;EA4DP,MAAA;EA1DA;;;;EA+DA,iBAAA;EA9DE;;;;EAmEF,gBAAA;AAAA;AAAA,KAGU,sBAAA,GAAyB,0BAAA;EAEjC,aAAA;AAAA;EArEF;;;;;EA4EE,aAAA;EACA,gBAAA;AAAA;AAAA,KAIQ,sBAAA;EACV,OAAA;EACA,IAAA;EACA,MAAA;EACA,KAAA;EAjF4E;;AAQ9E;EA6EE,KAAA;AAAA;AAAA,KAGU,uBAAA,GAA0B,iBAAA;EACpC,aAAA;AAAA;AAAA,iBAEc,6BAAA,CAA8B,OAAA,EAAS,uBAAA,GAA0B,SAAA;AAAA,KAQrE,uBAAA,GAA0B,iBAAA;EACpC,sBAAA,GAAyB,YAAA;EACzB,cAAA,GAAiB,YAAA;AAAA;AAAA,iBAEH,6BAAA,CAA8B,OAAA,EAAS,uBAAA,GAA0B,SAAA"}

package/dist/esm/lib/stack-app/teams/index.js

@@ -0,0 +1,35 @@
+//#region src/lib/stack-app/teams/index.ts
+function teamUpdateOptionsToCrud(options) {
+	return {
+		display_name: options.displayName,
+		profile_image_url: options.profileImageUrl,
+		client_metadata: options.clientMetadata
+	};
+}
+function teamCreateOptionsToCrud(options, creatorUserId) {
+	return {
+		display_name: options.displayName,
+		profile_image_url: options.profileImageUrl,
+		creator_user_id: creatorUserId
+	};
+}
+function serverTeamCreateOptionsToCrud(options) {
+	return {
+		display_name: options.displayName,
+		profile_image_url: options.profileImageUrl,
+		creator_user_id: options.creatorUserId
+	};
+}
+function serverTeamUpdateOptionsToCrud(options) {
+	return {
+		display_name: options.displayName,
+		profile_image_url: options.profileImageUrl,
+		client_metadata: options.clientMetadata,
+		client_read_only_metadata: options.clientReadOnlyMetadata,
+		server_metadata: options.serverMetadata
+	};
+}
+
+//#endregion
+export { serverTeamCreateOptionsToCrud, serverTeamUpdateOptionsToCrud, teamCreateOptionsToCrud, teamUpdateOptionsToCrud };
+//# sourceMappingURL=index.js.map

package/dist/esm/lib/stack-app/teams/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../../src/lib/stack-app/teams/index.ts"],"sourcesContent":["\n//===========================================\n// THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY, INSTEAD EDIT THE CORRESPONDING FILE IN packages/template\n//===========================================\nimport { TeamsCrud } from \"@stackframe/stack-shared/dist/interface/crud/teams\";\nimport { ReadonlyJson } from \"@stackframe/stack-shared/dist/utils/json\";\n\nimport { ApiKeyCreationOptions, TeamApiKey, TeamApiKeyFirstView } from \"../api-keys\";\nimport { AsyncStoreProperty } from \"../common\";\nimport { Customer } from \"../customers\";\nimport { ServerUser } from \"../users\";\n\n\nexport type TeamMemberProfile = {\n  displayName: string | null,\n  profileImageUrl: string | null,\n}\n\nexport type TeamMemberProfileUpdateOptions = {\n  displayName?: string,\n  profileImageUrl?: string | null,\n};\n\nexport type EditableTeamMemberProfile = TeamMemberProfile & {\n  update(update: TeamMemberProfileUpdateOptions): Promise<void>,\n}\n\nexport type TeamUser = {\n  id: string,\n  teamProfile: TeamMemberProfile,\n}\n\n/**\n * A team invitation as seen from the team's perspective (ie. the sender).\n *\n * Returned by `team.listInvitations()`. Contains the recipient email and allows\n * revoking the invitation.\n */\nexport type SentTeamInvitation = {\n  id: string,\n  recipientEmail: string | null,\n  expiresAt: Date,\n  revoke(): Promise<void>,\n}\n\n/**\n * @deprecated Use `SentTeamInvitation` instead.\n */\nexport type TeamInvitation = SentTeamInvitation;\n\n/**\n * A team invitation as seen from the invited user's perspective (ie. the receiver).\n *\n * Returned by `user.listTeamInvitations()`. Contains information about teams that have\n * sent invitations to any of the user's verified email addresses, and allows accepting\n * the invitation to join the team.\n */\nexport type ReceivedTeamInvitation = {\n  id: string,\n  teamId: string,\n  teamDisplayName: string,\n  recipientEmail: string,\n  expiresAt: Date,\n\n  /**\n   * Accepts the invitation, adding the current user to the team.\n   *\n   * The user must have a verified email address matching the invitation's recipient email.\n   */\n  accept(): Promise<void>,\n}\n\nexport type Team = {\n  id: string,\n  displayName: string,\n  profileImageUrl: string | null,\n  clientMetadata: any,\n  clientReadOnlyMetadata: any,\n  inviteUser(options: { email: string, callbackUrl?: string }): Promise<void>,\n  listUsers(): Promise<TeamUser[]>,\n  listInvitations(): Promise<SentTeamInvitation[]>,\n  update(update: TeamUpdateOptions): Promise<void>,\n  delete(): Promise<void>,\n  createApiKey(options: ApiKeyCreationOptions<\"team\">): Promise<TeamApiKeyFirstView>,\n} & AsyncStoreProperty<\"apiKeys\", [], TeamApiKey[], true> & Customer;\n\nexport type TeamUpdateOptions = {\n  displayName?: string,\n  profileImageUrl?: string | null,\n  clientMetadata?: ReadonlyJson,\n};\nexport function teamUpdateOptionsToCrud(options: TeamUpdateOptions): TeamsCrud[\"Client\"][\"Update\"] {\n  return {\n    display_name: options.displayName,\n    profile_image_url: options.profileImageUrl,\n    client_metadata: options.clientMetadata,\n  };\n}\n\nexport type TeamCreateOptions = {\n  displayName: string,\n  profileImageUrl?: string,\n}\nexport function teamCreateOptionsToCrud(options: TeamCreateOptions, creatorUserId: string): TeamsCrud[\"Client\"][\"Create\"] {\n  return {\n    display_name: options.displayName,\n    profile_image_url: options.profileImageUrl,\n    creator_user_id: creatorUserId,\n  };\n}\n\n\nexport type ServerTeamMemberProfile = TeamMemberProfile;\n\nexport type ServerTeamUser = ServerUser & {\n  teamProfile: ServerTeamMemberProfile,\n}\n\nexport type ServerTeam = {\n  createdAt: Date,\n  serverMetadata: any,\n  listUsers(): Promise<ServerTeamUser[]>,\n  update(update: ServerTeamUpdateOptions): Promise<void>,\n  delete(): Promise<void>,\n  addUser(userId: string): Promise<void>,\n  inviteUser(options: { email: string, callbackUrl?: string }): Promise<void>,\n  removeUser(userId: string): Promise<void>,\n} & Team;\n\ntype ServerListUsersOptionsBase = {\n  cursor?: string,\n  limit?: number,\n  orderBy?: 'signedUpAt' | 'lastActiveAt',\n  desc?: boolean,\n  /**\n   * Free-text search. Matches user ID (exact UUID), display name, and contact channels (e.g. primary email).\n   */\n  query?: string,\n  /**\n   * Only return users who are members of the given team.\n   */\n  teamId?: string,\n  /**\n   * Whether to include restricted users (users who haven't completed onboarding requirements).\n   * Defaults to false.\n   */\n  includeRestricted?: boolean,\n  /**\n   * Whether to include anonymous users (and restricted users).\n   * Defaults to false.\n   */\n  includeAnonymous?: boolean,\n};\n\nexport type ServerListUsersOptions = ServerListUsersOptionsBase & (\n  {\n    onlyAnonymous?: false,\n  } | {\n  /**\n   * Whether to return only anonymous users.\n   * Requires includeAnonymous=true.\n   * Defaults to false.\n   */\n    onlyAnonymous: true,\n    includeAnonymous: true,\n  }\n);\n\nexport type ServerListTeamsOptions = {\n  orderBy?: 'createdAt',\n  desc?: boolean,\n  cursor?: string,\n  limit?: number,\n  /**\n   * Free-text search. Matches team ID (exact UUID) and display name.\n   */\n  query?: string,\n};\n\nexport type ServerTeamCreateOptions = TeamCreateOptions & {\n  creatorUserId?: string,\n};\nexport function serverTeamCreateOptionsToCrud(options: ServerTeamCreateOptions): TeamsCrud[\"Server\"][\"Create\"] {\n  return {\n    display_name: options.displayName,\n    profile_image_url: options.profileImageUrl,\n    creator_user_id: options.creatorUserId,\n  };\n}\n\nexport type ServerTeamUpdateOptions = TeamUpdateOptions & {\n  clientReadOnlyMetadata?: ReadonlyJson,\n  serverMetadata?: ReadonlyJson,\n};\nexport function serverTeamUpdateOptionsToCrud(options: ServerTeamUpdateOptions): TeamsCrud[\"Server\"][\"Update\"] {\n  return {\n    display_name: options.displayName,\n    profile_image_url: options.profileImageUrl,\n    client_metadata: options.clientMetadata,\n    client_read_only_metadata: options.clientReadOnlyMetadata,\n    server_metadata: options.serverMetadata,\n  };\n}\n"],"mappings":";AA2FA,SAAgB,wBAAwB,SAA2D;AACjG,QAAO;EACL,cAAc,QAAQ;EACtB,mBAAmB,QAAQ;EAC3B,iBAAiB,QAAQ;EAC1B;;AAOH,SAAgB,wBAAwB,SAA4B,eAAsD;AACxH,QAAO;EACL,cAAc,QAAQ;EACtB,mBAAmB,QAAQ;EAC3B,iBAAiB;EAClB;;AA0EH,SAAgB,8BAA8B,SAAiE;AAC7G,QAAO;EACL,cAAc,QAAQ;EACtB,mBAAmB,QAAQ;EAC3B,iBAAiB,QAAQ;EAC1B;;AAOH,SAAgB,8BAA8B,SAAiE;AAC7G,QAAO;EACL,cAAc,QAAQ;EACtB,mBAAmB,QAAQ;EAC3B,iBAAiB,QAAQ;EACzB,2BAA2B,QAAQ;EACnC,iBAAiB,QAAQ;EAC1B"}

package/dist/esm/lib/stack-app/url-targets.d.ts

@@ -0,0 +1,39 @@
+import { DefaultHandlerUrlTarget, HandlerUrlOptions, ResolvedHandlerUrls } from "./common";
+
+//#region src/lib/stack-app/url-targets.d.ts
+declare const getHostedHandlerUrl: (options: {
+  projectId: string;
+  pagePath: string;
+}) => string;
+declare const isLocalHandlerUrlTarget: (options: {
+  targetUrl: string;
+  handlerPath: string;
+  currentOrigin?: string;
+}) => boolean;
+declare const resolveHandlerUrls: (options: {
+  urls: HandlerUrlOptions | undefined;
+  projectId: string;
+}) => ResolvedHandlerUrls;
+declare const buildCliAuthConfirmUrl: (options: {
+  cliAuthConfirmUrl: string; /** Used as the base URL only when cliAuthConfirmUrl is relative. */
+  appUrl: string;
+  loginCode: string;
+}) => string;
+declare const resolveUnknownHandlerPathFallbackUrl: (options: {
+  defaultTarget: DefaultHandlerUrlTarget | undefined;
+  projectId: string;
+  unknownPath: string;
+}) => string | null;
+declare function getPagePrompt(pageName: string, currentVersion?: number): {
+  title: string;
+  fullPrompt: string;
+  upgradePrompt: string | null;
+  latestVersion: number;
+} | null;
+declare const isHostedHandlerUrlForProject: (options: {
+  url: string;
+  projectId: string;
+}) => boolean;
+//#endregion
+export { buildCliAuthConfirmUrl, getHostedHandlerUrl, getPagePrompt, isHostedHandlerUrlForProject, isLocalHandlerUrlTarget, resolveHandlerUrls, resolveUnknownHandlerPathFallbackUrl };
+//# sourceMappingURL=url-targets.d.ts.map

package/dist/esm/lib/stack-app/url-targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-targets.d.ts","names":[],"sources":["../../../../src/lib/stack-app/url-targets.ts"],"mappings":";;;cA2Ga,mBAAA,GAAuB,OAAA;EAAW,SAAA;EAAmB,QAAA;AAAA;AAAA,cAmBrD,uBAAA,GAA2B,OAAA;EACtC,SAAA;EACA,WAAA;EACA,aAAA;AAAA;AAAA,cA4DW,kBAAA,GAAsB,OAAA;EAAW,IAAA,EAAM,iBAAA;EAA+B,SAAA;AAAA,MAAsB,mBAAA;AAAA,cA4I5F,sBAAA,GAA0B,OAAA;EACrC,iBAAA,UA3MA;EA6MA,MAAA;EACA,SAAA;AAAA;AAAA,cAOW,oCAAA,GAAwC,OAAA;EACnD,aAAA,EAAe,uBAAA;EACf,SAAA;EACA,WAAA;AAAA;AAAA,iBAiBc,aAAA,CAAc,QAAA,UAAkB,cAAA;EAA4B,KAAA;EAAe,UAAA;EAAoB,aAAA;EAA8B,aAAA;AAAA;AAAA,cAuBhI,4BAAA,GAAgC,OAAA;EAAW,GAAA;EAAa,SAAA;AAAA"}

package/dist/esm/lib/stack-app/url-targets.js

@@ -0,0 +1,266 @@
+import { HexclaveAssertionError } from "@hexclave/shared/dist/utils/errors";
+import { getCustomPagePrompts } from "@hexclave/shared/dist/interface/handler-urls";
+import { getHostedHandlerUrlFromConfig } from "@hexclave/shared/dist/utils/redirect-urls";
+import { envVars } from "../env.js";
+
+//#region src/lib/stack-app/url-targets.ts
+const localUrlPlaceholderOrigin = "http://example.com";
+const schemePrefixRegex = /^[a-zA-Z][a-zA-Z\d+\-.]*:/;
+const customPagePrompts = getCustomPagePrompts();
+const joinHandlerComponentPath = (basePath, pagePath) => {
+	const normalizedBasePath = basePath.endsWith("/") && basePath.length > 1 ? basePath.slice(0, -1) : basePath;
+	if (pagePath.length === 0) return normalizedBasePath;
+	if (normalizedBasePath === "/") return `/${pagePath}`;
+	return `${normalizedBasePath}/${pagePath}`;
+};
+const getHostedPagePathForHandlerName = (handlerName) => {
+	switch (handlerName) {
+		case "handler": return "";
+		case "home": return "";
+		case "afterSignIn": return "";
+		case "afterSignUp": return "";
+		case "afterSignOut": return "";
+		case "signIn": return "sign-in";
+		case "signUp": return "sign-up";
+		case "signOut": return "sign-out";
+		case "emailVerification": return "email-verification";
+		case "passwordReset": return "password-reset";
+		case "forgotPassword": return "forgot-password";
+		case "oauthCallback": return "oauth-callback";
+		case "magicLinkCallback": return "magic-link-callback";
+		case "accountSettings": return "account-settings";
+		case "teamInvitation": return "team-invitation";
+		case "cliAuthConfirm": return "cli-auth-confirm";
+		case "mfa": return "mfa";
+		case "error": return "error";
+		case "onboarding": return "onboarding";
+	}
+};
+const resolveCustomTargetUrl = (options) => {
+	const handlerName = options.handlerName;
+	if (handlerName in customPagePrompts) {
+		const customPagePrompt = customPagePrompts[handlerName];
+		if (options.target.version === 0 || options.target.version in customPagePrompt.versions) return options.target.url;
+		throw new Error(`Unsupported custom page version ${options.target.version} for ${options.handlerName} page at ${options.target.url}. The latest supported version of this page is ${Math.max(0, ...Object.keys(customPagePrompt.versions).map(Number))}. Please upgrade your Hexclave SDK to a version that supports this version.`);
+	} else throw new Error(`URL target ${options.handlerName} cannot be a custom page. Please specify the URL as a string instead.`);
+};
+const getHostedHandlerUrl = (options) => {
+	const normalizedPagePath = options.pagePath.replace(/^\/+/, "");
+	const hostedPath = normalizedPagePath.length > 0 ? `handler/${normalizedPagePath}` : "handler";
+	return getHostedHandlerUrlFromConfig({
+		projectId: options.projectId,
+		hostedPath,
+		hostedHandlerDomainSuffix: envVars.NEXT_PUBLIC_STACK_HOSTED_HANDLER_DOMAIN_SUFFIX,
+		hostedHandlerUrlTemplate: envVars.NEXT_PUBLIC_STACK_HOSTED_HANDLER_URL_TEMPLATE,
+		stackPortPrefix: envVars.NEXT_PUBLIC_HEXCLAVE_PORT_PREFIX
+	});
+};
+const isRelativeUrlString = (url) => {
+	if (url.startsWith("//")) return false;
+	return !schemePrefixRegex.test(url);
+};
+const isLocalHandlerUrlTarget = (options) => {
+	const urlObject = new URL(options.targetUrl, localUrlPlaceholderOrigin);
+	if (!(urlObject.pathname === options.handlerPath || urlObject.pathname.startsWith(`${options.handlerPath}/`))) return false;
+	if (options.currentOrigin == null) return true;
+	return isRelativeUrlString(options.targetUrl) || urlObject.origin === options.currentOrigin;
+};
+const resolveUrlTarget = (options) => {
+	if (typeof options.target === "string") return options.target;
+	switch (options.target.type) {
+		case "handler-component": return options.fallbackPath;
+		case "hosted": return getHostedHandlerUrl({
+			projectId: options.projectId,
+			pagePath: getHostedPagePathForHandlerName(options.handlerName)
+		});
+		case "custom": return resolveCustomTargetUrl({
+			target: options.target,
+			handlerName: options.handlerName
+		});
+	}
+};
+const assertOAuthCallbackTargetIsRelative = (target) => {
+	const url = typeof target === "string" ? target : target.type === "custom" ? target.url : null;
+	if (url != null && !isRelativeUrlString(url)) throw new HexclaveAssertionError("OAuth callback URLs must be relative.", {
+		oauthCallbackUrl: url,
+		hint: "Use a relative URL like '/handler/oauth-callback', or use { type: 'hosted' } to let Stack use the current page for hosted callbacks."
+	});
+};
+const resolveHandlerUrls = (options) => {
+	const configuredUrls = options.urls;
+	const defaultTarget = configuredUrls?.default ?? { type: "handler-component" };
+	const oauthCallbackTarget = configuredUrls?.oauthCallback ?? (defaultTarget.type === "hosted" ? defaultTarget : { type: "handler-component" });
+	assertOAuthCallbackTargetIsRelative(oauthCallbackTarget);
+	let handlerComponentBasePath = "/handler";
+	if (typeof configuredUrls?.handler === "string") handlerComponentBasePath = configuredUrls.handler;
+	else if (configuredUrls?.handler != null && configuredUrls.handler.type === "custom") handlerComponentBasePath = resolveCustomTargetUrl({
+		target: configuredUrls.handler,
+		handlerName: "handler"
+	});
+	const home = resolveUrlTarget({
+		target: configuredUrls?.home ?? defaultTarget,
+		fallbackPath: "/",
+		handlerName: "home",
+		projectId: options.projectId
+	});
+	const afterSignIn = resolveUrlTarget({
+		target: configuredUrls?.afterSignIn ?? defaultTarget,
+		fallbackPath: home,
+		handlerName: "afterSignIn",
+		projectId: options.projectId
+	});
+	return {
+		handler: resolveUrlTarget({
+			target: configuredUrls?.handler ?? defaultTarget,
+			fallbackPath: handlerComponentBasePath,
+			handlerName: "handler",
+			projectId: options.projectId
+		}),
+		signIn: resolveUrlTarget({
+			target: configuredUrls?.signIn ?? defaultTarget,
+			fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, "sign-in"),
+			handlerName: "signIn",
+			projectId: options.projectId
+		}),
+		signUp: resolveUrlTarget({
+			target: configuredUrls?.signUp ?? defaultTarget,
+			fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, "sign-up"),
+			handlerName: "signUp",
+			projectId: options.projectId
+		}),
+		afterSignIn,
+		afterSignUp: resolveUrlTarget({
+			target: configuredUrls?.afterSignUp ?? defaultTarget,
+			fallbackPath: afterSignIn,
+			handlerName: "afterSignUp",
+			projectId: options.projectId
+		}),
+		signOut: resolveUrlTarget({
+			target: configuredUrls?.signOut ?? defaultTarget,
+			fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, "sign-out"),
+			handlerName: "signOut",
+			projectId: options.projectId
+		}),
+		afterSignOut: resolveUrlTarget({
+			target: configuredUrls?.afterSignOut ?? defaultTarget,
+			fallbackPath: home,
+			handlerName: "afterSignOut",
+			projectId: options.projectId
+		}),
+		emailVerification: resolveUrlTarget({
+			target: configuredUrls?.emailVerification ?? defaultTarget,
+			fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, "email-verification"),
+			handlerName: "emailVerification",
+			projectId: options.projectId
+		}),
+		passwordReset: resolveUrlTarget({
+			target: configuredUrls?.passwordReset ?? defaultTarget,
+			fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, "password-reset"),
+			handlerName: "passwordReset",
+			projectId: options.projectId
+		}),
+		forgotPassword: resolveUrlTarget({
+			target: configuredUrls?.forgotPassword ?? defaultTarget,
+			fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, "forgot-password"),
+			handlerName: "forgotPassword",
+			projectId: options.projectId
+		}),
+		home,
+		oauthCallback: resolveUrlTarget({
+			target: oauthCallbackTarget,
+			fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, "oauth-callback"),
+			handlerName: "oauthCallback",
+			projectId: options.projectId
+		}),
+		magicLinkCallback: resolveUrlTarget({
+			target: configuredUrls?.magicLinkCallback ?? defaultTarget,
+			fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, "magic-link-callback"),
+			handlerName: "magicLinkCallback",
+			projectId: options.projectId
+		}),
+		accountSettings: resolveUrlTarget({
+			target: configuredUrls?.accountSettings ?? defaultTarget,
+			fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, "account-settings"),
+			handlerName: "accountSettings",
+			projectId: options.projectId
+		}),
+		teamInvitation: resolveUrlTarget({
+			target: configuredUrls?.teamInvitation ?? defaultTarget,
+			fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, "team-invitation"),
+			handlerName: "teamInvitation",
+			projectId: options.projectId
+		}),
+		cliAuthConfirm: resolveUrlTarget({
+			target: configuredUrls?.cliAuthConfirm ?? defaultTarget,
+			fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, "cli-auth-confirm"),
+			handlerName: "cliAuthConfirm",
+			projectId: options.projectId
+		}),
+		mfa: resolveUrlTarget({
+			target: configuredUrls?.mfa ?? defaultTarget,
+			fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, "mfa"),
+			handlerName: "mfa",
+			projectId: options.projectId
+		}),
+		error: resolveUrlTarget({
+			target: configuredUrls?.error ?? defaultTarget,
+			fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, "error"),
+			handlerName: "error",
+			projectId: options.projectId
+		}),
+		onboarding: resolveUrlTarget({
+			target: configuredUrls?.onboarding ?? defaultTarget,
+			fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, "onboarding"),
+			handlerName: "onboarding",
+			projectId: options.projectId
+		})
+	};
+};
+const buildCliAuthConfirmUrl = (options) => {
+	const url = new URL(options.cliAuthConfirmUrl, options.appUrl);
+	url.searchParams.set("login_code", options.loginCode);
+	return url.toString();
+};
+const resolveUnknownHandlerPathFallbackUrl = (options) => {
+	switch ((options.defaultTarget ?? { type: "handler-component" }).type) {
+		case "handler-component": return null;
+		case "hosted": return getHostedHandlerUrl({
+			projectId: options.projectId,
+			pagePath: options.unknownPath
+		});
+	}
+};
+function getPagePrompt(pageName, currentVersion) {
+	if (!(pageName in customPagePrompts)) return null;
+	const prompt = customPagePrompts[pageName];
+	const versionKeys = Object.keys(prompt.versions).map(Number);
+	const latestVersion = versionKeys.length > 0 ? Math.max(...versionKeys) : 0;
+	let upgradePrompt = null;
+	if (currentVersion != null) {
+		const prompts = versionKeys.filter((v) => v > currentVersion).sort((a, b) => a - b).map((v) => prompt.versions[v].upgradePrompt).filter((p) => p.length > 0);
+		upgradePrompt = prompts.length > 0 ? prompts.join("\n\n") : null;
+	} else upgradePrompt = (latestVersion > 0 ? prompt.versions[latestVersion] : void 0)?.upgradePrompt ?? null;
+	return {
+		title: prompt.title,
+		fullPrompt: prompt.fullPrompt,
+		upgradePrompt,
+		latestVersion
+	};
+}
+const isHostedHandlerUrlForProject = (options) => {
+	let parsedUrl;
+	try {
+		parsedUrl = new URL(options.url);
+	} catch {
+		return false;
+	}
+	const hostedBaseUrl = new URL(getHostedHandlerUrl({
+		projectId: options.projectId,
+		pagePath: ""
+	}));
+	return parsedUrl.origin === hostedBaseUrl.origin && (parsedUrl.pathname === hostedBaseUrl.pathname || parsedUrl.pathname.startsWith(`${hostedBaseUrl.pathname}/`));
+};
+
+//#endregion
+export { buildCliAuthConfirmUrl, getHostedHandlerUrl, getPagePrompt, isHostedHandlerUrlForProject, isLocalHandlerUrlTarget, resolveHandlerUrls, resolveUnknownHandlerPathFallbackUrl };
+//# sourceMappingURL=url-targets.js.map

package/dist/esm/lib/stack-app/url-targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-targets.js","names":[],"sources":["../../../../src/lib/stack-app/url-targets.ts"],"sourcesContent":["\n//===========================================\n// THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY, INSTEAD EDIT THE CORRESPONDING FILE IN packages/template\n//===========================================\nimport { getCustomPagePrompts, type CustomPagePrompt } from \"@stackframe/stack-shared/dist/interface/handler-urls\";\nimport { HexclaveAssertionError } from \"@stackframe/stack-shared/dist/utils/errors\";\nimport { getHostedHandlerUrlFromConfig } from \"@stackframe/stack-shared/dist/utils/redirect-urls\";\nimport { envVars } from \"../env\";\nimport { DefaultHandlerUrlTarget, HandlerPageUrls, HandlerUrlOptions, HandlerUrlTarget, HandlerUrls, ResolvedHandlerUrls } from \"./common\";\n\nconst localUrlPlaceholderOrigin = \"http://example.com\";\nconst schemePrefixRegex = /^[a-zA-Z][a-zA-Z\\d+\\-.]*:/;\n\nconst customPagePrompts: Record<keyof Omit<HandlerPageUrls, \"handler\">, CustomPagePrompt> = getCustomPagePrompts();\n\nconst joinHandlerComponentPath = (basePath: string, pagePath: string): string => {\n  const normalizedBasePath = basePath.endsWith(\"/\") && basePath.length > 1\n    ? basePath.slice(0, -1)\n    : basePath;\n  if (pagePath.length === 0) {\n    return normalizedBasePath;\n  }\n  if (normalizedBasePath === \"/\") {\n    return `/${pagePath}`;\n  }\n  return `${normalizedBasePath}/${pagePath}`;\n};\n\nconst getHostedPagePathForHandlerName = (handlerName: keyof HandlerUrls): string => {\n  switch (handlerName) {\n    case \"handler\": {\n      return \"\";\n    }\n    case \"home\": {\n      return \"\";\n    }\n    case \"afterSignIn\": {\n      return \"\";\n    }\n    case \"afterSignUp\": {\n      return \"\";\n    }\n    case \"afterSignOut\": {\n      return \"\";\n    }\n    case \"signIn\": {\n      return \"sign-in\";\n    }\n    case \"signUp\": {\n      return \"sign-up\";\n    }\n    case \"signOut\": {\n      return \"sign-out\";\n    }\n    case \"emailVerification\": {\n      return \"email-verification\";\n    }\n    case \"passwordReset\": {\n      return \"password-reset\";\n    }\n    case \"forgotPassword\": {\n      return \"forgot-password\";\n    }\n    case \"oauthCallback\": {\n      return \"oauth-callback\";\n    }\n    case \"magicLinkCallback\": {\n      return \"magic-link-callback\";\n    }\n    case \"accountSettings\": {\n      return \"account-settings\";\n    }\n    case \"teamInvitation\": {\n      return \"team-invitation\";\n    }\n    case \"cliAuthConfirm\": {\n      return \"cli-auth-confirm\";\n    }\n    case \"mfa\": {\n      return \"mfa\";\n    }\n    case \"error\": {\n      return \"error\";\n    }\n    case \"onboarding\": {\n      return \"onboarding\";\n    }\n  }\n};\n\nconst resolveCustomTargetUrl = (options: {\n  target: { type: \"custom\", url: string, version: number },\n  handlerName: keyof HandlerUrls,\n}): string => {\n  const handlerName = options.handlerName;\n  if (handlerName in customPagePrompts) {\n    const customPagePrompt = customPagePrompts[handlerName as keyof typeof customPagePrompts];\n    if (options.target.version === 0 || options.target.version in customPagePrompt.versions) {\n      return options.target.url;\n    }\n\n    throw new Error(`Unsupported custom page version ${options.target.version} for ${options.handlerName} page at ${options.target.url}. The latest supported version of this page is ${Math.max(0, ...Object.keys(customPagePrompt.versions).map(Number))}. Please upgrade your Hexclave SDK to a version that supports this version.`);\n  } else {\n    throw new Error(`URL target ${options.handlerName} cannot be a custom page. Please specify the URL as a string instead.`);\n  }\n};\n\nexport const getHostedHandlerUrl = (options: { projectId: string, pagePath: string }): string => {\n  const normalizedPagePath = options.pagePath.replace(/^\\/+/, \"\");\n  const hostedPath = normalizedPagePath.length > 0 ? `handler/${normalizedPagePath}` : \"handler\";\n  return getHostedHandlerUrlFromConfig({\n    projectId: options.projectId,\n    hostedPath,\n    hostedHandlerDomainSuffix: envVars.NEXT_PUBLIC_STACK_HOSTED_HANDLER_DOMAIN_SUFFIX,\n    hostedHandlerUrlTemplate: envVars.NEXT_PUBLIC_STACK_HOSTED_HANDLER_URL_TEMPLATE,\n    stackPortPrefix: envVars.NEXT_PUBLIC_HEXCLAVE_PORT_PREFIX,\n  });\n};\n\nconst isRelativeUrlString = (url: string): boolean => {\n  if (url.startsWith(\"//\")) {\n    return false;\n  }\n  return !schemePrefixRegex.test(url);\n};\n\nexport const isLocalHandlerUrlTarget = (options: {\n  targetUrl: string,\n  handlerPath: string,\n  currentOrigin?: string,\n}): boolean => {\n  const urlObject = new URL(options.targetUrl, localUrlPlaceholderOrigin);\n  const isHandlerPathTarget = urlObject.pathname === options.handlerPath\n    || urlObject.pathname.startsWith(`${options.handlerPath}/`);\n  if (!isHandlerPathTarget) {\n    return false;\n  }\n\n  // On server we only have path information, so treat matching handler paths as local.\n  if (options.currentOrigin == null) {\n    return true;\n  }\n\n  return isRelativeUrlString(options.targetUrl) || urlObject.origin === options.currentOrigin;\n};\n\nconst resolveUrlTarget = (options: {\n  target: HandlerUrlTarget,\n  fallbackPath: string,\n  handlerName: keyof HandlerUrls,\n  projectId: string,\n}): string => {\n  if (typeof options.target === \"string\") {\n    return options.target;\n  }\n\n  switch (options.target.type) {\n    case \"handler-component\": {\n      return options.fallbackPath;\n    }\n    case \"hosted\": {\n      return getHostedHandlerUrl({\n        projectId: options.projectId,\n        pagePath: getHostedPagePathForHandlerName(options.handlerName),\n      });\n    }\n    case \"custom\": {\n      return resolveCustomTargetUrl({\n        target: options.target,\n        handlerName: options.handlerName,\n      });\n    }\n  }\n};\n\nconst assertOAuthCallbackTargetIsRelative = (target: HandlerUrlTarget): void => {\n  const url = typeof target === \"string\"\n    ? target\n    : target.type === \"custom\"\n      ? target.url\n      : null;\n  if (url != null && !isRelativeUrlString(url)) {\n    throw new HexclaveAssertionError(\"OAuth callback URLs must be relative.\", {\n      oauthCallbackUrl: url,\n      hint: \"Use a relative URL like '/handler/oauth-callback', or use { type: 'hosted' } to let Stack use the current page for hosted callbacks.\",\n    });\n  }\n};\n\nexport const resolveHandlerUrls = (options: { urls: HandlerUrlOptions | undefined, projectId: string }): ResolvedHandlerUrls => {\n  const configuredUrls = options.urls;\n  const defaultTarget = configuredUrls?.default ?? { type: \"handler-component\" } as const;\n  const oauthCallbackTarget: HandlerUrlTarget = configuredUrls?.oauthCallback ?? (\n    defaultTarget.type === \"hosted\"\n      ? defaultTarget\n      : { type: \"handler-component\" }\n  );\n  assertOAuthCallbackTargetIsRelative(oauthCallbackTarget);\n  let handlerComponentBasePath = \"/handler\";\n  if (typeof configuredUrls?.handler === \"string\") {\n    handlerComponentBasePath = configuredUrls.handler;\n  } else if (configuredUrls?.handler != null && configuredUrls.handler.type === \"custom\") {\n    handlerComponentBasePath = resolveCustomTargetUrl({\n      target: configuredUrls.handler,\n      handlerName: \"handler\",\n    });\n  }\n\n  const home = resolveUrlTarget({\n    target: configuredUrls?.home ?? defaultTarget,\n    fallbackPath: \"/\",\n    handlerName: \"home\",\n    projectId: options.projectId,\n  });\n  const afterSignIn = resolveUrlTarget({\n    target: configuredUrls?.afterSignIn ?? defaultTarget,\n    fallbackPath: home,\n    handlerName: \"afterSignIn\",\n    projectId: options.projectId,\n  });\n\n  return {\n    handler: resolveUrlTarget({\n      target: configuredUrls?.handler ?? defaultTarget,\n      fallbackPath: handlerComponentBasePath,\n      handlerName: \"handler\",\n      projectId: options.projectId,\n    }),\n    signIn: resolveUrlTarget({\n      target: configuredUrls?.signIn ?? defaultTarget,\n      fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, \"sign-in\"),\n      handlerName: \"signIn\",\n      projectId: options.projectId,\n    }),\n    signUp: resolveUrlTarget({\n      target: configuredUrls?.signUp ?? defaultTarget,\n      fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, \"sign-up\"),\n      handlerName: \"signUp\",\n      projectId: options.projectId,\n    }),\n    afterSignIn,\n    afterSignUp: resolveUrlTarget({\n      target: configuredUrls?.afterSignUp ?? defaultTarget,\n      fallbackPath: afterSignIn,\n      handlerName: \"afterSignUp\",\n      projectId: options.projectId,\n    }),\n    signOut: resolveUrlTarget({\n      target: configuredUrls?.signOut ?? defaultTarget,\n      fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, \"sign-out\"),\n      handlerName: \"signOut\",\n      projectId: options.projectId,\n    }),\n    afterSignOut: resolveUrlTarget({\n      target: configuredUrls?.afterSignOut ?? defaultTarget,\n      fallbackPath: home,\n      handlerName: \"afterSignOut\",\n      projectId: options.projectId,\n    }),\n    emailVerification: resolveUrlTarget({\n      target: configuredUrls?.emailVerification ?? defaultTarget,\n      fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, \"email-verification\"),\n      handlerName: \"emailVerification\",\n      projectId: options.projectId,\n    }),\n    passwordReset: resolveUrlTarget({\n      target: configuredUrls?.passwordReset ?? defaultTarget,\n      fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, \"password-reset\"),\n      handlerName: \"passwordReset\",\n      projectId: options.projectId,\n    }),\n    forgotPassword: resolveUrlTarget({\n      target: configuredUrls?.forgotPassword ?? defaultTarget,\n      fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, \"forgot-password\"),\n      handlerName: \"forgotPassword\",\n      projectId: options.projectId,\n    }),\n    home,\n    oauthCallback: resolveUrlTarget({\n      target: oauthCallbackTarget,\n      fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, \"oauth-callback\"),\n      handlerName: \"oauthCallback\",\n      projectId: options.projectId,\n    }),\n    magicLinkCallback: resolveUrlTarget({\n      target: configuredUrls?.magicLinkCallback ?? defaultTarget,\n      fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, \"magic-link-callback\"),\n      handlerName: \"magicLinkCallback\",\n      projectId: options.projectId,\n    }),\n    accountSettings: resolveUrlTarget({\n      target: configuredUrls?.accountSettings ?? defaultTarget,\n      fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, \"account-settings\"),\n      handlerName: \"accountSettings\",\n      projectId: options.projectId,\n    }),\n    teamInvitation: resolveUrlTarget({\n      target: configuredUrls?.teamInvitation ?? defaultTarget,\n      fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, \"team-invitation\"),\n      handlerName: \"teamInvitation\",\n      projectId: options.projectId,\n    }),\n    cliAuthConfirm: resolveUrlTarget({\n      target: configuredUrls?.cliAuthConfirm ?? defaultTarget,\n      fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, \"cli-auth-confirm\"),\n      handlerName: \"cliAuthConfirm\",\n      projectId: options.projectId,\n    }),\n    mfa: resolveUrlTarget({\n      target: configuredUrls?.mfa ?? defaultTarget,\n      fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, \"mfa\"),\n      handlerName: \"mfa\",\n      projectId: options.projectId,\n    }),\n    error: resolveUrlTarget({\n      target: configuredUrls?.error ?? defaultTarget,\n      fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, \"error\"),\n      handlerName: \"error\",\n      projectId: options.projectId,\n    }),\n    onboarding: resolveUrlTarget({\n      target: configuredUrls?.onboarding ?? defaultTarget,\n      fallbackPath: joinHandlerComponentPath(handlerComponentBasePath, \"onboarding\"),\n      handlerName: \"onboarding\",\n      projectId: options.projectId,\n    }),\n  };\n};\n\nexport const buildCliAuthConfirmUrl = (options: {\n  cliAuthConfirmUrl: string,\n  /** Used as the base URL only when cliAuthConfirmUrl is relative. */\n  appUrl: string,\n  loginCode: string,\n}): string => {\n  const url = new URL(options.cliAuthConfirmUrl, options.appUrl);\n  url.searchParams.set(\"login_code\", options.loginCode);\n  return url.toString();\n};\n\nexport const resolveUnknownHandlerPathFallbackUrl = (options: {\n  defaultTarget: DefaultHandlerUrlTarget | undefined,\n  projectId: string,\n  unknownPath: string,\n}): string | null => {\n  const defaultTarget = options.defaultTarget ?? { type: \"handler-component\" } satisfies DefaultHandlerUrlTarget;\n\n  switch (defaultTarget.type) {\n    case \"handler-component\": {\n      return null;\n    }\n    case \"hosted\": {\n      return getHostedHandlerUrl({\n        projectId: options.projectId,\n        pagePath: options.unknownPath,\n      });\n    }\n  }\n};\n\nexport function getPagePrompt(pageName: string, currentVersion?: number): { title: string; fullPrompt: string; upgradePrompt: string | null; latestVersion: number } | null {\n  if (!(pageName in customPagePrompts)) return null;\n  const prompt = customPagePrompts[pageName as keyof typeof customPagePrompts];\n  const versionKeys = Object.keys(prompt.versions).map(Number);\n  const latestVersion = versionKeys.length > 0 ? Math.max(...versionKeys) : 0;\n\n  let upgradePrompt: string | null = null;\n  if (currentVersion != null) {\n    const relevantVersions = versionKeys\n      .filter(v => v > currentVersion)\n      .sort((a, b) => a - b);\n    const prompts = relevantVersions\n      .map(v => prompt.versions[v].upgradePrompt)\n      .filter(p => p.length > 0);\n    upgradePrompt = prompts.length > 0 ? prompts.join(\"\\n\\n\") : null;\n  } else {\n    const upgradeEntry = latestVersion > 0 ? prompt.versions[latestVersion] : undefined;\n    upgradePrompt = upgradeEntry?.upgradePrompt ?? null;\n  }\n\n  return { title: prompt.title, fullPrompt: prompt.fullPrompt, upgradePrompt, latestVersion };\n}\n\nexport const isHostedHandlerUrlForProject = (options: { url: string, projectId: string }): boolean => {\n  let parsedUrl: URL;\n  try {\n    parsedUrl = new URL(options.url);\n  } catch {\n    return false;\n  }\n\n  const hostedBaseUrl = new URL(getHostedHandlerUrl({ projectId: options.projectId, pagePath: \"\" }));\n  return parsedUrl.origin === hostedBaseUrl.origin\n    && (parsedUrl.pathname === hostedBaseUrl.pathname || parsedUrl.pathname.startsWith(`${hostedBaseUrl.pathname}/`));\n};\n"],"mappings":"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"}

package/dist/esm/lib/stack-app/url-targets.test.d.ts

@@ -0,0 +1 @@
+export { };