@stats-forge/github-stats-forge-core 0.1.0 → 0.3.0

package/build/api/contributed-to.d.ts

@@ -0,0 +1,23 @@
+import * as z from 'zod/mini';
+/**
+ * Render the contributed-to card for a set of query params.
+ *
+ * @returns The rendered card, or a rendered error.
+ */
+export declare const contributedTo: (query: import("./params.ts").ApiQuery<z.ZodMiniObject<{
+    username: z.ZodMiniType<string | undefined, string | undefined, z.core.$ZodTypeInternals<string | undefined, string | undefined>>;
+    locale: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<string | undefined, string | undefined>>;
+    repos_count: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<number | undefined, string | undefined>>;
+    include_own_repos: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<boolean | undefined, string | undefined>>;
+    exclude_repo: z.ZodMiniType<string[], string | undefined, z.core.$ZodTypeInternals<string[], string | undefined>>;
+    from: z.ZodMiniType<Date | undefined, string | undefined, z.core.$ZodTypeInternals<Date | undefined, string | undefined>>;
+    to: z.ZodMiniType<Date | undefined, string | undefined, z.core.$ZodTypeInternals<Date | undefined, string | undefined>>;
+    hide_years: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<boolean | undefined, string | undefined>>;
+    hide_title: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<boolean | undefined, string | undefined>>;
+    hide_border: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<boolean | undefined, string | undefined>>;
+    card_width: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<number | undefined, string | undefined>>;
+    custom_title: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    border_radius: z.ZodMiniType<number | undefined, string | undefined, z.core.$ZodTypeInternals<number | undefined, string | undefined>>;
+    disable_animations: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<boolean | undefined, string | undefined>>;
+}, z.core.$strip>>, config: import("./index.ts").CardConfig) => Promise<import("./api-result.ts").ApiResult>;
+//# sourceMappingURL=contributed-to.d.ts.map

package/build/api/contributed-to.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contributed-to.d.ts","sourceRoot":"","sources":["../../src/api/contributed-to.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAuC9B;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;4GAuCzB,CAAC"}

package/build/api/contributed-to.js

@@ -0,0 +1,43 @@
+import * as z from 'zod/mini';
+import { renderContributedToCard } from '../cards/contributed-to.js';
+import { fetchContributedTo } from '../fetchers/contributed-to.js';
+import { cardHandler } from './handler.js';
+import { booleanParam, fromParam, localeParam, looseIntParam, numberParam, ORDERED_RANGE, rawParam, safeListParam, toParam, usernameParam, } from './params.js';
+/** What the contributed-to endpoint accepts, on top of the shared color params. */
+const contributedToQuery = z
+    .object({
+    username: usernameParam,
+    locale: localeParam,
+    repos_count: looseIntParam,
+    include_own_repos: booleanParam,
+    exclude_repo: safeListParam,
+    from: fromParam,
+    to: toParam,
+    hide_years: booleanParam,
+    hide_title: booleanParam,
+    hide_border: booleanParam,
+    card_width: looseIntParam,
+    custom_title: rawParam,
+    border_radius: numberParam,
+    disable_animations: booleanParam,
+})
+    .check(ORDERED_RANGE);
+/**
+ * Render the contributed-to card for a set of query params.
+ *
+ * @returns The rendered card, or a rendered error.
+ */
+export const contributedTo = cardHandler(contributedToQuery, async ({ username, locale, repos_count, include_own_repos, exclude_repo, from, to, hide_years, hide_title, hide_border, card_width, custom_title, border_radius, disable_animations, }, colors, config) => {
+    const data = await fetchContributedTo({ username, include_own_repos, repos_count, exclude_repo, from, to }, config);
+    return renderContributedToCard(data, {
+        ...colors,
+        locale,
+        hide_years,
+        hide_title,
+        hide_border,
+        card_width,
+        custom_title,
+        border_radius,
+        disable_animations,
+    });
+});

package/build/api/gist.d.ts

@@ -1,22 +1,15 @@
 import * as z from 'zod/mini';
-import type { CardConfig } from '../common/config.ts';
-import type { ApiResult } from './api-result.ts';
-import type { ApiQuery } from './params.ts';
-/** What the gist endpoint accepts, on top of the shared color params. */
-declare const gistQuery: z.ZodMiniObject<{
-    id: z.ZodMiniType<string | undefined, string | undefined, z.core.$ZodTypeInternals<string | undefined, string | undefined>>;
-    border_radius: z.ZodMiniType<number | undefined, string | undefined, z.core.$ZodTypeInternals<number | undefined, string | undefined>>;
-    show_owner: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<boolean | undefined, string | undefined>>;
-    browser_rendering: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<boolean | undefined, string | undefined>>;
-    hide_border: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<boolean | undefined, string | undefined>>;
-}, z.core.$strip>;
-/** The query this endpoint accepts, checked against the schema above. */
-type GistApiQuery = ApiQuery<typeof gistQuery>;
 /**
  * Render the gist card for a set of query params.
  *
  * @returns The rendered card, or a rendered error.
  */
-export declare const gist: (query: GistApiQuery, config: CardConfig) => Promise<ApiResult>;
-export {};
+export declare const gist: (query: import("./params.ts").ApiQuery<z.ZodMiniObject<{
+    id: z.ZodMiniType<string | undefined, string | undefined, z.core.$ZodTypeInternals<string | undefined, string | undefined>>;
+    locale: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<string | undefined, string | undefined>>;
+    border_radius: z.ZodMiniType<number | undefined, string | undefined, z.core.$ZodTypeInternals<number | undefined, string | undefined>>;
+    show_owner: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<boolean | undefined, string | undefined>>;
+    browser_rendering: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<boolean | undefined, string | undefined>>;
+    hide_border: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<boolean | undefined, string | undefined>>;
+}, z.core.$strip>>, config: import("./index.ts").CardConfig) => Promise<import("./api-result.ts").ApiResult>;
 //# sourceMappingURL=gist.d.ts.map

package/build/api/gist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gist.d.ts","sourceRoot":"","sources":["../../src/api/gist.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAG9B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,yEAAyE;AACzE,QAAA,MAAM,SAAS;;;;;;iBAMb,CAAC;AAEH,yEAAyE;AACzE,KAAK,YAAY,GAAG,QAAQ,CAAC,OAAO,SAAS,CAAC,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,IAAI,UAAiB,YAAY,UAAU,UAAU,KAAG,OAAO,CAAC,SAAS,CA8BrF,CAAC"}
+{"version":3,"file":"gist.d.ts","sourceRoot":"","sources":["../../src/api/gist.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAkB9B;;;;GAIG;AACH,eAAO,MAAM,IAAI;;;;;;;4GAkBhB,CAAC"}

package/build/api/gist.js

@@ -1,11 +1,12 @@
 import * as z from 'zod/mini';
 import { renderGistCard } from '../cards/gist.js';
 import { fetchGist } from '../fetchers/gist.js';
-import { errorResult } from './api-result.js';
-import { booleanParam, numberParam, parseColorParams, parseParams, safeParam } from './params.js';
+import { cardHandler } from './handler.js';
+import { booleanParam, localeParam, numberParam, safeParam } from './params.js';
 /** What the gist endpoint accepts, on top of the shared color params. */
 const gistQuery = z.object({
     id: safeParam,
+    locale: localeParam,
     border_radius: numberParam,
     show_owner: booleanParam,
     browser_rendering: booleanParam,
@@ -16,30 +17,14 @@ const gistQuery = z.object({
  *
  * @returns The rendered card, or a rendered error.
  */
-export const gist = async (query, config) => {
-    let colors;
-    try {
-        colors = parseColorParams(query);
-    }
-    catch (error) {
-        // A rejected color cannot be used to draw its own error card.
-        return errorResult(error);
-    }
-    try {
-        const { id, border_radius, show_owner, browser_rendering, hide_border } = parseParams(gistQuery, query);
-        const gistData = await fetchGist({ id }, config);
-        return {
-            status: 'success',
-            content: renderGistCard(gistData, {
-                ...colors,
-                border_radius,
-                show_owner,
-                browser_rendering,
-                hide_border,
-            }),
-        };
-    }
-    catch (error) {
-        return errorResult(error, colors);
-    }
-};
+export const gist = cardHandler(gistQuery, async ({ id, locale, border_radius, show_owner, browser_rendering, hide_border }, colors, config) => {
+    const gistData = await fetchGist({ id }, config);
+    return renderGistCard(gistData, {
+        ...colors,
+        locale,
+        border_radius,
+        show_owner,
+        browser_rendering,
+        hide_border,
+    });
+});

package/build/api/handler.d.ts

@@ -0,0 +1,16 @@
+import type * as z from 'zod/mini';
+import type { ColorParams } from '../common/color.ts';
+import type { CardConfig } from '../common/config.ts';
+import type { ApiResult } from './api-result.ts';
+import type { ApiQuery } from './params.ts';
+/**
+ * An endpoint: the schema it accepts, and what it draws from the parsed params.
+ *
+ * Colors parse first and on their own, because a rejected color cannot be used to draw its own error card.
+ * Parsing throws, fetching throws, and one `catch` turns whatever was thrown into the answer.
+ *
+ * @returns The handler, taking the query the schema describes.
+ */
+declare const cardHandler: <TSchema extends z.ZodMiniType>(schema: TSchema, render: (params: z.output<TSchema>, colors: ColorParams, config: CardConfig) => Promise<string>) => (query: ApiQuery<TSchema>, config: CardConfig) => Promise<ApiResult>;
+export { cardHandler };
+//# sourceMappingURL=handler.d.ts.map

package/build/api/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/api/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,CAAC,MAAM,UAAU,CAAC;AAEnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;;;;GAOG;AACH,QAAA,MAAM,WAAW,GACd,OAAO,SAAS,CAAC,CAAC,WAAW,UACpB,OAAO,UACP,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,CAAC,aAEnF,QAAQ,CAAC,OAAO,CAAC,UAAU,UAAU,KAAG,OAAO,CAAC,SAAS,CAgBtE,CAAC;AAEJ,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/build/api/handler.js

@@ -0,0 +1,29 @@
+import { errorResult } from './api-result.js';
+import { parseColorParams, parseParams } from './params.js';
+/**
+ * An endpoint: the schema it accepts, and what it draws from the parsed params.
+ *
+ * Colors parse first and on their own, because a rejected color cannot be used to draw its own error card.
+ * Parsing throws, fetching throws, and one `catch` turns whatever was thrown into the answer.
+ *
+ * @returns The handler, taking the query the schema describes.
+ */
+const cardHandler = (schema, render) => async (query, config) => {
+    let colors;
+    try {
+        colors = parseColorParams(query);
+    }
+    catch (error) {
+        return errorResult(error);
+    }
+    try {
+        return {
+            status: 'success',
+            content: await render(parseParams(schema, query), colors, config),
+        };
+    }
+    catch (error) {
+        return errorResult(error, colors);
+    }
+};
+export { cardHandler };

package/build/api/index.d.ts

@@ -1,3 +1,4 @@
+export { contributedTo } from './contributed-to.ts';
 export { gist } from './gist.ts';
 export { pin } from './pin.ts';
 export { stats } from './stats.ts';

package/build/api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG3D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG3D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}

package/build/api/index.js

@@ -1,3 +1,4 @@
+export { contributedTo } from './contributed-to.js';
 export { gist } from './gist.js';
 export { pin } from './pin.js';
 export { stats } from './stats.js';

package/build/api/params.d.ts

@@ -31,12 +31,18 @@ declare const numberParam: z.ZodMiniType<number | undefined, string | undefined>
  * `NaN` reaches the renderer, which answers it with its own default.
  */
 declare const looseIntParam: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<number | undefined, string | undefined>>;
+/** The start of a card's range; see {@link rangeParam}. */
+declare const fromParam: z.ZodMiniType<Date | undefined, string | undefined, z.core.$ZodTypeInternals<Date | undefined, string | undefined>>;
+/** The end of a card's range; see {@link rangeParam}. */
+declare const toParam: z.ZodMiniType<Date | undefined, string | undefined, z.core.$ZodTypeInternals<Date | undefined, string | undefined>>;
 /**
- * A four-digit year.
- * Anything else builds a `DateTime` GitHub rejects, so it is a permanent error here rather than a failed request later.
- * Yields the year, or `undefined` when the param is absent.
+ * The pair-level rule the two ends cannot see on their own.
+ * Every endpoint taking a range applies it, so an order no card could draw is rejected once.
  */
-declare const yearParam: z.ZodMiniType<number | undefined, string | undefined>;
+declare const ORDERED_RANGE: z.core.$ZodCheck<{
+    from?: Date | undefined;
+    to?: Date | undefined;
+}>;
 /**
  * An id the fetchers put in a URL.
  * Rejected before any request is made, and yielded unchanged otherwise.
@@ -92,5 +98,5 @@ declare const parseParams: <TSchema extends z.ZodMiniType>(schema: TSchema, quer
  */
 declare const parseColorParams: (query: unknown) => ColorParams;
 export type { ApiQuery };
-export { booleanParam, enumParam, listParam, localeParam, looseIntParam, numberParam, parseColorParams, parseParams, rawParam, safeListParam, safeParam, usernameParam, yearParam, };
+export { booleanParam, enumParam, fromParam, listParam, ORDERED_RANGE, localeParam, looseIntParam, numberParam, parseColorParams, parseParams, rawParam, safeListParam, safeParam, toParam, usernameParam, };
 //# sourceMappingURL=params.d.ts.map

package/build/api/params.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../src/api/params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAE9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAOtD;;;;;;;;GAQG;AAEH,sDAAsD;AACtD,QAAA,MAAM,QAAQ,4CAAyB,CAAC;AAiCxC;;;GAGG;AACH,QAAA,MAAM,YAAY,wHAIjB,CAAC;AAEF,8DAA8D;AAC9D,QAAA,MAAM,SAAS,6GAA4C,CAAC;AAE5D;;;;;;GAMG;AACH,QAAA,MAAM,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,SAAS,EAAE,MAAM,GAAG,SAAS,CAGtE,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,aAAa,uHAGlB,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,SAAS,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,SAAS,EAAE,MAAM,GAAG,SAAS,CAGpE,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,SAAS,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,SAAS,EAAE,MAAM,GAAG,SAAS,CAEpE,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,aAAa,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,SAAS,EAAE,MAAM,GAAG,SAAS,CAExE,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,aAAa,EAAE,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAGnE,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,WAAW,uHAGhB,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,SAAS,GAAI,KAAK,CAAC,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,UAC9C,CAAC,KACR,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,SAAS,EAAE,MAAM,GAAG,SAAS,CACqC,CAAC;AAmBhG;;;;GAIG;AACH,KAAK,QAAQ,CAAC,OAAO,SAAS,CAAC,CAAC,WAAW,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,WAAW,CAAC;AAcvF;;;;;;;;;GASG;AACH,QAAA,MAAM,WAAW,GAAI,OAAO,SAAS,CAAC,CAAC,WAAW,UACxC,OAAO,SACR,OAAO,KACb,CAAC,CAAC,MAAM,CAAC,OAAO,CAMlB,CAAC;AAEF;;;;;;;GAOG;AACH,QAAA,MAAM,gBAAgB,UAAW,OAAO,KAAG,WAAoD,CAAC;AAEhG,YAAY,EAAE,QAAQ,EAAE,CAAC;AAEzB,OAAO,EACL,YAAY,EACZ,SAAS,EACT,SAAS,EACT,WAAW,EACX,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,aAAa,EACb,SAAS,EACT,aAAa,EACb,SAAS,GACV,CAAC"}
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../src/api/params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAE9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAQtD;;;;;;;;GAQG;AAEH,sDAAsD;AACtD,QAAA,MAAM,QAAQ,4CAAyB,CAAC;AA4CxC;;;GAGG;AACH,QAAA,MAAM,YAAY,wHAIjB,CAAC;AAEF,8DAA8D;AAC9D,QAAA,MAAM,SAAS,6GAA4C,CAAC;AAE5D;;;;;;GAMG;AACH,QAAA,MAAM,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,SAAS,EAAE,MAAM,GAAG,SAAS,CAGtE,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,aAAa,uHAGlB,CAAC;AAsBF,2DAA2D;AAC3D,QAAA,MAAM,SAAS,qHAAqB,CAAC;AAErC,yDAAyD;AACzD,QAAA,MAAM,OAAO,qHAAmB,CAAC;AAEjC;;;GAGG;AACH,QAAA,MAAM,aAAa;WAAqB,IAAI,GAAG,SAAS;SAAO,IAAI,GAAG,SAAS;EAG9E,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,SAAS,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,SAAS,EAAE,MAAM,GAAG,SAAS,CAEpE,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,aAAa,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,SAAS,EAAE,MAAM,GAAG,SAAS,CAExE,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,aAAa,EAAE,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAGnE,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,WAAW,uHAGhB,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,SAAS,GAAI,KAAK,CAAC,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,UAC9C,CAAC,KACR,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,SAAS,EAAE,MAAM,GAAG,SAAS,CACqC,CAAC;AAmBhG;;;;GAIG;AACH,KAAK,QAAQ,CAAC,OAAO,SAAS,CAAC,CAAC,WAAW,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,WAAW,CAAC;AAcvF;;;;;;;;;GASG;AACH,QAAA,MAAM,WAAW,GAAI,OAAO,SAAS,CAAC,CAAC,WAAW,UACxC,OAAO,SACR,OAAO,KACb,CAAC,CAAC,MAAM,CAAC,OAAO,CAMlB,CAAC;AAEF;;;;;;;GAOG;AACH,QAAA,MAAM,gBAAgB,UAAW,OAAO,KAAG,WAAoD,CAAC;AAEhG,YAAY,EAAE,QAAQ,EAAE,CAAC;AAEzB,OAAO,EACL,YAAY,EACZ,SAAS,EACT,SAAS,EACT,SAAS,EACT,aAAa,EACb,WAAW,EACX,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,aAAa,EACb,SAAS,EACT,OAAO,EACP,aAAa,GACd,CAAC"}

package/build/api/params.js

@@ -1,6 +1,7 @@
 import * as z from 'zod/mini';
 import { COLOR_PARAM_KEYS, THEME_PARAM_KEYS, isValidColorInput } from '../common/color.js';
 import { GITHUB_USERNAME_PATTERN } from '../common/constants.js';
+import { getWidestRange, parseRangeDate } from '../common/date.js';
 import { CardError } from '../common/error.js';
 import { parseArray, parseBoolean } from '../common/ops.js';
 import { isLocaleAvailable } from '../translations.js';
@@ -23,7 +24,9 @@ const SAFE_PATTERN = /^[-\w/.,]+$/;
  */
 const REJECTION_MESSAGES = {
     number: (param) => `Invalid number input for parameter "${param}"`,
-    year: (param) => `Invalid number input for parameter "${param}"`,
+    date: (param) => `Invalid date input for parameter "${param}"`,
+    out_of_range: (param) => `Out of range date for parameter "${param}"`,
+    inverted_range: () => 'Range "from" is after "to"',
     unsafe: (param) => `Parameter "${param}" contains unsafe characters`,
     username: (param) => `Invalid username input for parameter "${param}"`,
     locale: () => 'Locale not found',
@@ -62,11 +65,28 @@ const numberParam = z.pipe(rawParam.check(rejects('number', (value) => Number.is
  */
 const looseIntParam = z.pipe(rawParam, z.transform((value) => (value === undefined ? undefined : Number.parseInt(value, 10))));
 /**
- * A four-digit year.
- * Anything else builds a `DateTime` GitHub rejects, so it is a permanent error here rather than a failed request later.
- * Yields the year, or `undefined` when the param is absent.
+ * One end of the range a card counts within, written as `2024`, `2024-03` or `2024-03-15`.
+ *
+ * @returns Schema yielding the instant, or `undefined` when the param is absent.
+ */
+const rangeParam = (end) => {
+    const parse = (value) => parseRangeDate(value, end);
+    return z.pipe(rawParam.check(rejects('date', (value) => parse(value) !== undefined)).check(rejects('out_of_range', (value) => {
+        const date = parse(value);
+        const widest = getWidestRange();
+        // a bad shape is already reported by the check above
+        return date === undefined || (date >= widest.from && date <= widest.to);
+    })), z.transform((value) => (value === undefined ? undefined : parse(value))));
+};
+/** The start of a card's range; see {@link rangeParam}. */
+const fromParam = rangeParam('from');
+/** The end of a card's range; see {@link rangeParam}. */
+const toParam = rangeParam('to');
+/**
+ * The pair-level rule the two ends cannot see on their own.
+ * Every endpoint taking a range applies it, so an order no card could draw is rejected once.
  */
-const yearParam = z.pipe(rawParam.check(rejects('year', (value) => /^\d{4}$/.test(value))), z.transform((value) => (value === undefined ? undefined : Number(value))));
+const ORDERED_RANGE = z.refine(({ from, to }) => from === undefined || to === undefined || from <= to, { error: REJECTION_MESSAGES.inverted_range('from'), path: ['from'] });
 /**
  * An id the fetchers put in a URL.
  * Rejected before any request is made, and yielded unchanged otherwise.
@@ -144,4 +164,4 @@ const parseParams = (schema, query) => {
  * @returns The color params.
  */
 const parseColorParams = (query) => parseParams(colorParamsSchema, query);
-export { booleanParam, enumParam, listParam, localeParam, looseIntParam, numberParam, parseColorParams, parseParams, rawParam, safeListParam, safeParam, usernameParam, yearParam, };
+export { booleanParam, enumParam, fromParam, listParam, ORDERED_RANGE, localeParam, looseIntParam, numberParam, parseColorParams, parseParams, rawParam, safeListParam, safeParam, toParam, usernameParam, };

package/build/api/pin.d.ts

@@ -1,9 +1,9 @@
 import * as z from 'zod/mini';
-import type { CardConfig } from '../common/config.ts';
-import type { ApiResult } from './api-result.ts';
-import type { ApiQuery } from './params.ts';
-/** What the pin endpoint accepts, on top of the shared color params. */
-declare const pinQuery: z.ZodMiniObject<{
+/**
+ * The card, and the values each of its options accepts, keyed by the option's own name.
+ * A UI reads them off the function it calls: `pin.OPTIONS.show`.
+ */
+export declare const pin: ((query: import("./params.ts").ApiQuery<z.ZodMiniObject<{
     username: z.ZodMiniType<string | undefined, string | undefined, z.core.$ZodTypeInternals<string | undefined, string | undefined>>;
     repo: z.ZodMiniType<string | undefined, string | undefined, z.core.$ZodTypeInternals<string | undefined, string | undefined>>;
     hide_border: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<boolean | undefined, string | undefined>>;
@@ -18,14 +18,10 @@ declare const pinQuery: z.ZodMiniObject<{
     locale: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<string | undefined, string | undefined>>;
     border_radius: z.ZodMiniType<number | undefined, string | undefined, z.core.$ZodTypeInternals<number | undefined, string | undefined>>;
     description_lines_count: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<number | undefined, string | undefined>>;
-}, z.core.$strip>;
-/** The query this endpoint accepts, checked against the schema above. */
-type PinApiQuery = ApiQuery<typeof pinQuery>;
-/**
- * Render the repository card for a set of query params.
- *
- * @returns The rendered card, or a rendered error.
- */
-export declare const pin: (query: PinApiQuery, config: CardConfig) => Promise<ApiResult>;
-export {};
+}, z.core.$strip>>, config: import("./index.ts").CardConfig) => Promise<import("./api-result.ts").ApiResult>) & {
+    OPTIONS: {
+        show: readonly ["prs_authored", "prs_commented", "prs_reviewed", "issues_authored", "issues_commented"];
+        number_format: readonly ["short", "long"];
+    };
+};
 //# sourceMappingURL=pin.d.ts.map

package/build/api/pin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pin.d.ts","sourceRoot":"","sources":["../../src/api/pin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAG9B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAc5C,wEAAwE;AACxE,QAAA,MAAM,QAAQ;;;;;;;;;;;;;;;iBAeZ,CAAC;AAEH,yEAAyE;AACzE,KAAK,WAAW,GAAG,QAAQ,CAAC,OAAO,QAAQ,CAAC,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,GAAG,UAAiB,WAAW,UAAU,UAAU,KAAG,OAAO,CAAC,SAAS,CA8DnF,CAAC"}
+{"version":3,"file":"pin.d.ts","sourceRoot":"","sources":["../../src/api/pin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AA8F9B;;;GAGG;AACH,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;CAAgE,CAAC"}

package/build/api/pin.js

@@ -1,8 +1,8 @@
 import * as z from 'zod/mini';
 import { renderRepoCard } from '../cards/repo.js';
 import { fetchRepo } from '../fetchers/repo.js';
-import { errorResult } from './api-result.js';
-import { booleanParam, listParam, localeParam, looseIntParam, numberParam, parseColorParams, parseParams, rawParam, safeParam, usernameParam, } from './params.js';
+import { cardHandler } from './handler.js';
+import { booleanParam, listParam, localeParam, looseIntParam, numberParam, rawParam, safeParam, usernameParam, } from './params.js';
 /** What the pin endpoint accepts, on top of the shared color params. */
 const pinQuery = z.object({
     username: usernameParam,
@@ -25,47 +25,35 @@ const pinQuery = z.object({
  *
  * @returns The rendered card, or a rendered error.
  */
-export const pin = async (query, config) => {
-    let colors;
-    try {
-        colors = parseColorParams(query);
-    }
-    catch (error) {
-        // A rejected color cannot be used to draw its own error card.
-        return errorResult(error);
-    }
-    try {
-        const { username, repo, hide_border, card_width, show_owner, browser_rendering, show, show_icons, number_format, text_bold, line_height, locale, border_radius, description_lines_count, } = parseParams(pinQuery, query);
-        const repoData = await fetchRepo({
-            username,
-            reponame: repo,
-            include_prs_authored: show.includes('prs_authored'),
-            include_prs_commented: show.includes('prs_commented'),
-            include_prs_reviewed: show.includes('prs_reviewed'),
-            include_issues_authored: show.includes('issues_authored'),
-            include_issues_commented: show.includes('issues_commented'),
-        }, config);
-        return {
-            status: 'success',
-            content: renderRepoCard(repoData, {
-                ...colors,
-                hide_border,
-                border_radius,
-                card_width_input: card_width,
-                show_owner,
-                browser_rendering,
-                show,
-                show_icons,
-                number_format,
-                text_bold,
-                line_height,
-                username,
-                locale,
-                description_lines_count,
-            }),
-        };
-    }
-    catch (error) {
-        return errorResult(error, colors);
-    }
-};
+const renderPin = cardHandler(pinQuery, async ({ username, repo, hide_border, card_width, show_owner, browser_rendering, show, show_icons, number_format, text_bold, line_height, locale, border_radius, description_lines_count, }, colors, config) => {
+    const repoData = await fetchRepo({
+        username,
+        reponame: repo,
+        include_prs_authored: show.includes('prs_authored'),
+        include_prs_commented: show.includes('prs_commented'),
+        include_prs_reviewed: show.includes('prs_reviewed'),
+        include_issues_authored: show.includes('issues_authored'),
+        include_issues_commented: show.includes('issues_commented'),
+    }, config);
+    return renderRepoCard(repoData, {
+        ...colors,
+        hide_border,
+        border_radius,
+        card_width_input: card_width,
+        show_owner,
+        browser_rendering,
+        show,
+        show_icons,
+        number_format,
+        text_bold,
+        line_height,
+        username,
+        locale,
+        description_lines_count,
+    });
+});
+/**
+ * The card, and the values each of its options accepts, keyed by the option's own name.
+ * A UI reads them off the function it calls: `pin.OPTIONS.show`.
+ */
+export const pin = Object.assign(renderPin, { OPTIONS: renderRepoCard.OPTIONS });

package/build/api/stats.d.ts

@@ -1,9 +1,9 @@
 import * as z from 'zod/mini';
-import type { CardConfig } from '../common/config.ts';
-import type { ApiResult } from './api-result.ts';
-import type { ApiQuery } from './params.ts';
-/** What the stats endpoint accepts, on top of the shared color params. */
-declare const statsQuery: z.ZodMiniObject<{
+/**
+ * The card, and the values each of its options accepts, keyed by the option's own name.
+ * A UI reads them off the function it calls: `stats.OPTIONS.rank_icon`.
+ */
+export declare const stats: ((query: import("./params.ts").ApiQuery<z.ZodMiniObject<{
     username: z.ZodMiniType<string | undefined, string | undefined, z.core.$ZodTypeInternals<string | undefined, string | undefined>>;
     repo: z.ZodMiniType<string[], string | undefined, z.core.$ZodTypeInternals<string[], string | undefined>>;
     owner: z.ZodMiniType<string[], string | undefined, z.core.$ZodTypeInternals<string[], string | undefined>>;
@@ -14,7 +14,8 @@ declare const statsQuery: z.ZodMiniObject<{
     hide_rank: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<boolean | undefined, string | undefined>>;
     show_icons: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<boolean | undefined, string | undefined>>;
     include_all_commits: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<boolean | undefined, string | undefined>>;
-    commits_year: z.ZodMiniType<number | undefined, string | undefined, z.core.$ZodTypeInternals<number | undefined, string | undefined>>;
+    from: z.ZodMiniType<Date | undefined, string | undefined, z.core.$ZodTypeInternals<Date | undefined, string | undefined>>;
+    to: z.ZodMiniType<Date | undefined, string | undefined, z.core.$ZodTypeInternals<Date | undefined, string | undefined>>;
     line_height: z.ZodMiniOptional<z.ZodMiniString<string>>;
     text_bold: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<boolean | undefined, string | undefined>>;
     exclude_repo: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<string[], string | undefined>>;
@@ -28,21 +29,13 @@ declare const statsQuery: z.ZodMiniObject<{
     rank_icon: z.ZodMiniType<"default" | "github" | "percentile" | undefined, string | undefined, z.core.$ZodTypeInternals<"default" | "github" | "percentile" | undefined, string | undefined>>;
     show: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<string[], string | undefined>>;
     contribs_include_own_repos: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<boolean | undefined, string | undefined>>;
-}, z.core.$strip>;
-/** The query this endpoint accepts, checked against the schema above. */
-type StatsApiQuery = ApiQuery<typeof statsQuery>;
-/**
- * Render the stats card for a set of query params.
- *
- * @returns The rendered card, or a rendered error.
- */
-declare const renderStats: (query: StatsApiQuery, config: CardConfig) => Promise<ApiResult>;
-/**
- * The card, with the values its enum params accept.
- * A UI reads them off the function it calls, e.g. `stats.LAYOUTS`.
- */
-export declare const stats: typeof renderStats & {
-    RANK_ICONS: readonly ["default", "github", "percentile"];
+}, z.core.$strip>>, config: import("./index.ts").CardConfig) => Promise<import("./api-result.ts").ApiResult>) & {
+    OPTIONS: {
+        rank_icon: readonly ["default", "github", "percentile"];
+        show: readonly ["contributions", "prs_merged", "prs_merged_percentage", "reviews", "discussions_started", "discussions_answered", "prs_authored", "prs_commented", "prs_reviewed", "issues_authored", "issues_commented", "all_time_contribs"];
+        hide: readonly ["stars", "commits", "prs", "issues", "contribs"];
+        number_format: readonly ["short", "long"];
+        role: import("../graphql/generated/common.ts").RepositoryAffiliation[];
+    };
 };
-export {};
 //# sourceMappingURL=stats.d.ts.map

package/build/api/stats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/api/stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAG9B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAgB5C,0EAA0E;AAC1E,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;iBAyBd,CAAC;AAEH,yEAAyE;AACzE,KAAK,aAAa,GAAG,QAAQ,CAAC,OAAO,UAAU,CAAC,CAAC;AAEjD;;;;GAIG;AACH,QAAA,MAAM,WAAW,UAAiB,aAAa,UAAU,UAAU,KAAG,OAAO,CAAC,SAAS,CAoGtF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,KAAK;;CAEhB,CAAC"}
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/api/stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAuJ9B;;;GAGG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAEhB,CAAC"}