@volter/twin-github 0.1.0 → 0.1.1

package/src/github-shared.ts

@@ -0,0 +1,26 @@
+// GitHub SHARED helpers — pure shape functions both sides of the wire need: the twin's
+// mirror-state projection (server side, `github-mirror-state.ts`) and the mirror's React
+// client (`client/github-mirror.tsx`). Plain data in → plain data out; no state access,
+// no `@volter/twin`, no Bun/node imports — this module rides into the browser bundle
+// unchanged.
+
+/** The ONE named store the mirror renders from: `GET /twin/store/${GITHUB_MIRROR_STORE}`
+ *  (runtime contract R5 — the store door — is the only way a mirror reads twin state). */
+export const GITHUB_MIRROR_STORE = 'mirror';
+
+/** The store door's path, relative to the twin's base (the mirror host's origin). */
+export const GITHUB_MIRROR_STORE_PATH = `/twin/store/${GITHUB_MIRROR_STORE}`;
+
+/** GitHub's web origin — the projection's `url` fields are real github.com links. */
+export const GITHUB_WEB_ORIGIN = 'https://github.com';
+
+/** A pull request's web path (`/{owner}/{repo}/pull/{n}`) — the projection's `url` tail and
+ *  the console's own route for an opened PR are the same grammar, real GitHub's. */
+export function githubPullPath(repo: string, number: number | string): string {
+  return `/${repo}/pull/${number}`;
+}
+
+/** An issue's web path (`/{owner}/{repo}/issues/{n}`), the same way. */
+export function githubIssuePath(repo: string, number: number | string): string {
+  return `/${repo}/issues/${number}`;
+}