feat: homepage pagination and local db seeding

[zzeleznick]

Description

This PR intends to support #211 by adding simple pagination with a page URL parameters and a helper script to seed the db with some dummy data.

Adds

• tools/seed_submissions.ts script to pull in dummy data from HN for testing
• page option to specify the cursor (noting that there isn't yet a feed design that takes into account the date and score of the submissions)
• More button to navigate to the next page

Example

Notes

• Did not add numbering as this would require passing the start index along with the cursor which seems like a good indicator for a design discussion
• Thinking there should be an iterator or indexer by "hotness" / "recency" as part of future work

[iuioiua]

Nice approach! Please be sure to run deno task ok before pushing.

[iuioiua]

Mostly LGTM! However, I'm now getting the following error after running deno task db:seed:

An error occurred during route handling or page rendering. TypeError: Cannot read properties of null (reading 'login')
    at Object.ItemSummary (file:///Users/asher/GitHub/saaskit/components/ItemSummary.tsx:42:23)
    at https://esm.sh/v119/preact-render-to-string@5.2.6/X-ZS8q/deno/preact-render-to-string.mjs:12:1830
    at T (https://esm.sh/v119/preact-render-to-string@5.2.6/X-ZS8q/deno/preact-render-to-string.mjs:12:1857)
    at T (https://esm.sh/v119/preact-render-to-string@5.2.6/X-ZS8q/deno/preact-render-to-string.mjs:12:1074)
    at T (https://esm.sh/v119/preact-render-to-string@5.2.6/X-ZS8q/deno/preact-render-to-string.mjs:12:2844)
    at T (https://esm.sh/v119/preact-render-to-string@5.2.6/X-ZS8q/deno/preact-render-to-string.mjs:12:2844)
    at T (https://esm.sh/v119/preact-render-to-string@5.2.6/X-ZS8q/deno/preact-render-to-string.mjs:12:1933)
    at T (https://esm.sh/v119/preact-render-to-string@5.2.6/X-ZS8q/deno/preact-render-to-string.mjs:12:1074)
    at T (https://esm.sh/v119/preact-render-to-string@5.2.6/X-ZS8q/deno/preact-render-to-string.mjs:12:1933)
    at T (https://esm.sh/v119/preact-render-to-string@5.2.6/X-ZS8q/deno/preact-render-to-string.mjs:12:1933)

I suppose these are what your previous modifications to <ItemSummary /> were for. I think we just need to fill in some gaps when populating the KV database.

[zzeleznick]

@iuioiua – Yep. To minimize the diffs, I elected to make User optional as there is a flow in which a post can exist without a user in prod (e.g. user created, user posts, and then user is deleted) independently of the KV database population. LMK if this is reasonable.

[iuioiua]

The user deletion flow is not yet defined or implemented. Even if it were, it'd likely delete all objects relating to the user, including posts.

[zzeleznick]

@iuioiua – for context on my end, I saw a function and a corresponding test for user deletion -> https://github.com/denoland/saaskit/blob/main/utils/db_test.ts#L46

[iuioiua]

Ah, yes. deleteUser() is currently a test function. I'll create a PR to move it to the test file. Thanks for pointing that out!

[zzeleznick]

@iuioiua – Could you clarify what changes you need for this PR?

For demo or local testing purposes, I feel like emulating real users via the item.userId as a fallback for the user ID works well.

[iuioiua]

The changes to <UserPostedAt /> and <ItemSummary /> should be reverted. These components shouldn't be affected by this PR. Instead, the new seed submissions script should populate the ["users", id] index. Again, the properties in the User object when creating the user are arbitrary. So these values don't have to be based on real data if it's too annoying to do so 😄

[iuioiua]

Also, could you add a short explainer in the README (Getting Started Locally) and seed submissions script about what it does?

[zzeleznick]

@iuioiua – PTAL when you have the chance

• reverted changes to <UserPostedAt /> and <ItemSummary />
• created a dummy users with avatar URLs
• updated the Getting Started Locally in README.md
• updated the screenshot in the PR body

[iuioiua]

LGTM! Great work, @zzeleznick 💪🏾