create-feedbax 0.1.0 → 0.2.0

package/template/src/feedbax/feedback/notion-request.ts

@@ -0,0 +1,74 @@
+const MAX_ATTEMPTS = 3;
+const BASE_BACKOFF_MILLISECONDS = 250;
+const MAX_BACKOFF_MILLISECONDS = 2_000;
+
+export interface NotionRetryOptions {
+  sleep?: (milliseconds: number) => Promise<void>;
+  random?: () => number;
+}
+
+export async function requestNotion(
+  input: Parameters<typeof fetch>[0],
+  init: RequestInit = {},
+  {
+    request,
+    retry = {},
+    operation,
+  }: {
+    request: typeof fetch;
+    retry?: NotionRetryOptions;
+    operation: "create" | "idempotent";
+  },
+): Promise<Response> {
+  const sleep = retry.sleep ?? defaultSleep;
+  const random = retry.random ?? Math.random;
+
+  for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt += 1) {
+    const response = await request(input, init);
+    if (!isRetryableNotionFailure(response.status, operation)) return response;
+    if (attempt === MAX_ATTEMPTS) {
+      throw new Error(
+        `Notion request failed after ${MAX_ATTEMPTS} attempts (${response.status}).`,
+      );
+    }
+    await sleep(retryDelayMilliseconds(response, attempt, random));
+  }
+
+  throw new Error("Notion request retry loop ended unexpectedly.");
+}
+
+function isRetryableNotionFailure(
+  status: number,
+  operation: "create" | "idempotent",
+): boolean {
+  return status === 429 || (status === 529 && operation === "idempotent");
+}
+
+function retryDelayMilliseconds(
+  response: Response,
+  attempt: number,
+  random: () => number,
+): number {
+  const retryAfter = response.headers.get("Retry-After");
+  if (retryAfter) {
+    const seconds = Number(retryAfter);
+    if (Number.isFinite(seconds) && seconds >= 0) return seconds * 1_000;
+  }
+
+  return exponentialDelayMilliseconds(attempt, random);
+}
+
+function exponentialDelayMilliseconds(
+  attempt: number,
+  random: () => number,
+): number {
+  const ceiling = Math.min(
+    BASE_BACKOFF_MILLISECONDS * 2 ** (attempt - 1),
+    MAX_BACKOFF_MILLISECONDS,
+  );
+  return Math.round(ceiling / 2 + random() * (ceiling / 2));
+}
+
+async function defaultSleep(milliseconds: number): Promise<void> {
+  await new Promise<void>((resolve) => setTimeout(resolve, milliseconds));
+}

package/template/src/feedbax.test-fixture.ts

@@ -0,0 +1,64 @@
+import { defineFeedbax } from "@feedbax/config";
+
+// prettier-ignore
+export default defineFeedbax({
+  "product": {
+    "name": "Feedbax",
+    "description": "Share feedback and follow product progress.",
+    "logo": "/feedbax-mark.svg"
+  },
+  "theme": {
+    "preset": "lyra-neutral"
+  },
+  "notion": {
+    "databaseId": "test-database",
+    "dataSourceId": "test-feedback",
+    "properties": {
+      "title": "test-title",
+      "slug": "test-slug",
+      "description": "test-description",
+      "type": "test-type",
+      "status": "test-status",
+      "published": "test-published",
+      "voteCount": "test-voteCount",
+      "teamResponse": "test-teamResponse",
+      "releaseNotesUrl": "test-releaseNotesUrl",
+      "submitterName": "test-submitterName",
+      "submitterEmail": "test-submitterEmail",
+      "source": "test-source",
+      "externalId": "test-externalId",
+      "editTokenHash": "test-editTokenHash",
+      "createdAt": "test-createdAt",
+      "updatedAt": "test-updatedAt"
+    }
+  },
+  "changelog": {
+    "databaseId": "test-database",
+    "dataSourceId": "test-changelog",
+    "properties": {
+      "title": "test-title",
+      "slug": "test-slug",
+      "date": "test-date",
+      "summary": "test-summary",
+      "body": "test-body",
+      "labels": "test-labels",
+      "image": "test-image",
+      "published": "test-published",
+      "createdAt": "test-createdAt",
+      "updatedAt": "test-updatedAt"
+    }
+  },
+  "features": {
+    "voting": true,
+    "comments": true,
+    "changelog": true
+  },
+  "submissions": {
+    "moderation": "required",
+    "maxTitleLength": 120,
+    "maxDescriptionLength": 5000
+  },
+  "turnstile": {
+    "enabled": false
+  }
+});

package/template/src/feedbax.ts

@@ -0,0 +1,69 @@
+import { defineFeedbax } from "@feedbax/config";
+
+const turnstileSiteKey =
+  import.meta.env?.VITE_TURNSTILE_SITE_KEY ??
+  process.env.VITE_TURNSTILE_SITE_KEY;
+
+const env = (name: string) => process.env[name] ?? "not-configured";
+
+export default defineFeedbax({
+  product: {
+    name: "Feedbax",
+    description: "Share feedback and follow product progress.",
+    logo: "/feedbax-mark.svg",
+    siteUrl: process.env.FEEDBAX_SITE_URL,
+  },
+  theme: { preset: "lyra-neutral" },
+  notion: {
+    databaseId: env("NOTION_FEEDBACK_DATABASE_ID"),
+    dataSourceId: env("NOTION_FEEDBACK_DATA_SOURCE_ID"),
+    properties: {
+      title: env("NOTION_FEEDBACK_TITLE_PROPERTY_ID"),
+      slug: env("NOTION_FEEDBACK_SLUG_PROPERTY_ID"),
+      description: env("NOTION_FEEDBACK_DESCRIPTION_PROPERTY_ID"),
+      type: env("NOTION_FEEDBACK_TYPE_PROPERTY_ID"),
+      status: env("NOTION_FEEDBACK_STATUS_PROPERTY_ID"),
+      published: env("NOTION_FEEDBACK_PUBLISHED_PROPERTY_ID"),
+      voteCount: env("NOTION_FEEDBACK_VOTE_COUNT_PROPERTY_ID"),
+      teamResponse: env("NOTION_FEEDBACK_TEAM_RESPONSE_PROPERTY_ID"),
+      releaseNotesUrl: env("NOTION_FEEDBACK_RELEASE_NOTES_URL_PROPERTY_ID"),
+      submitterName: env("NOTION_FEEDBACK_SUBMITTER_NAME_PROPERTY_ID"),
+      submitterEmail: env("NOTION_FEEDBACK_SUBMITTER_EMAIL_PROPERTY_ID"),
+      source: env("NOTION_FEEDBACK_SOURCE_PROPERTY_ID"),
+      externalId: env("NOTION_FEEDBACK_EXTERNAL_ID_PROPERTY_ID"),
+      editTokenHash: env("NOTION_FEEDBACK_EDIT_TOKEN_HASH_PROPERTY_ID"),
+      createdAt: env("NOTION_FEEDBACK_CREATED_AT_PROPERTY_ID"),
+      updatedAt: env("NOTION_FEEDBACK_UPDATED_AT_PROPERTY_ID"),
+    },
+  },
+  changelog: {
+    databaseId: env("NOTION_CHANGELOG_DATABASE_ID"),
+    dataSourceId: env("NOTION_CHANGELOG_DATA_SOURCE_ID"),
+    properties: {
+      title: env("NOTION_CHANGELOG_TITLE_PROPERTY_ID"),
+      slug: env("NOTION_CHANGELOG_SLUG_PROPERTY_ID"),
+      date: env("NOTION_CHANGELOG_DATE_PROPERTY_ID"),
+      summary: env("NOTION_CHANGELOG_SUMMARY_PROPERTY_ID"),
+      body: env("NOTION_CHANGELOG_BODY_PROPERTY_ID"),
+      labels: env("NOTION_CHANGELOG_LABELS_PROPERTY_ID"),
+      image: env("NOTION_CHANGELOG_IMAGE_PROPERTY_ID"),
+      published: env("NOTION_CHANGELOG_PUBLISHED_PROPERTY_ID"),
+      createdAt: env("NOTION_CHANGELOG_CREATED_AT_PROPERTY_ID"),
+      updatedAt: env("NOTION_CHANGELOG_UPDATED_AT_PROPERTY_ID"),
+    },
+  },
+  features: {
+    voting: process.env.FEEDBAX_VOTING_ENABLED !== "false",
+    comments: process.env.FEEDBAX_COMMENTS_ENABLED !== "false",
+    changelog: process.env.FEEDBAX_CHANGELOG_ENABLED !== "false",
+  },
+  submissions: {
+    moderation: "required",
+    maxTitleLength: 120,
+    maxDescriptionLength: 5_000,
+  },
+  turnstile: {
+    enabled: Boolean(turnstileSiteKey),
+    siteKey: turnstileSiteKey,
+  },
+});