@better-giving/endowment 1.0.9 → 1.0.11

package/dist/cloudsearch.d.mts

@@ -1,6 +1,6 @@
 import type { ToDoc, ToHitFields, ToUpdate } from "@better-giving/types/cloudsearch";
 import type { Endow, Environment } from "./db.mjs";
-export type Fields = Pick<Endow.DBRecord, "card_img" | "name" | "tagline" | "hq_country" | "sdgs" | "active_in_countries" | "endow_designation" | "registration_number" | "kyc_donors_only" | "claimed" | "env" | "id" | "published" | "fund_opt_in"> & {
+export type Fields = Pick<Endow.DbRecord, "card_img" | "name" | "tagline" | "hq_country" | "sdgs" | "active_in_countries" | "endow_designation" | "registration_number" | "kyc_donors_only" | "claimed" | "env" | "id" | "published" | "fund_opt_in"> & {
     contributions_total: number;
     contributions_count: number;
 };

package/dist/db.d.mts

@@ -1,6 +1,6 @@
-import type { EndowId, Endowment as EndowmentShape, Environment, Milestone as MilestoneShape, MilestoneId, Program as ProgramShape, ProgramId } from "./schema.mjs";
+import type { EndowId, Endowment as EndowmentShape, Environment, MediaId, MediaType, Milestone as MilestoneShape, MilestoneId, Program as ProgramShape, ProgramId } from "./schema.mjs";
 export type { EndowId, SocialMediaURLs, Allocation, Increment, EndowDesignation, Environment, ProgramId, } from "./schema.mjs";
-export declare const gsi: {
+export declare const endowGsi: {
     readonly regnumEnv: "regnum-env-gsi";
     readonly slugEnv: "slug-env-gsi";
 };
@@ -32,17 +32,17 @@ export declare namespace Endow {
         /** @deprecated */
         sfCompounded?: boolean;
     };
-    type DBRecord = Keys & NonKeyAttributes;
+    type DbRecord = Keys & NonKeyAttributes;
 }
 export declare namespace RegNumEnvGsi {
-    type Name = typeof gsi.regnumEnv;
+    type Name = typeof endowGsi.regnumEnv;
     type Keys = Pick<Endow.NonKeyAttributes, "registration_number" | "env">;
-    type DBRecord = Keys & Endow.Keys & Pick<Endow.NonKeyAttributes, "claimed" | "name" | "hq_country" | "id">;
+    type DbRecord = Keys & Endow.Keys & Pick<Endow.NonKeyAttributes, "claimed" | "name" | "hq_country" | "id">;
 }
 export declare namespace SlugEnvGsi {
-    type Name = typeof gsi.slugEnv;
+    type Name = typeof endowGsi.slugEnv;
     type Keys = Pick<Endow.NonKeyAttributes, "slug" | "env">;
-    type DBRecord = Endow.DBRecord;
+    type DbRecord = Endow.DbRecord;
 }
 export declare namespace Program {
     type Keys = {
@@ -53,7 +53,7 @@ export declare namespace Program {
         /** in USD */
         totalDonations?: number;
     };
-    export type DBRecord = Keys & NonKeyAttributes;
+    export type DbRecord = Keys & NonKeyAttributes;
     export {};
 }
 export declare namespace Milestone {
@@ -61,6 +61,35 @@ export declare namespace Milestone {
         PK: `Prog#${string}#${Environment}`;
         SK: `Mile#${MilestoneId}`;
     };
-    export type DBRecord = Keys & MilestoneShape;
+    export type DbRecord = Keys & MilestoneShape;
     export {};
 }
+export declare const mediaGsi: {
+    readonly 1: "gsi1";
+};
+export declare namespace Media {
+    type Keys = {
+        PK: `Endow#${EndowId}#${Environment}`;
+        SK: `Media#${MediaId}`;
+    };
+    /** "0" - featured (goes before 1), "1" - not-featured */
+    type FeaturedFlag = "0" | "1";
+    type NonKeyAttributes = {
+        id: MediaId;
+        gsi1PK: Keys["PK"];
+        gsi1SK: `MediaList#${FeaturedFlag}#${MediaId}#${MediaType}`;
+        /** iso string */
+        dateCreated: string;
+    };
+    type VideoAttributes = NonKeyAttributes & {
+        type: Extract<MediaType, "video">;
+        url: string;
+    };
+    type VideoDbRecord = Keys & VideoAttributes;
+    type DbRecord = VideoDbRecord;
+    namespace Gsi1 {
+        type Name = (typeof mediaGsi)[1];
+        type Keys = Pick<NonKeyAttributes, "gsi1PK" | "gsi1SK">;
+        type DbRecord = Keys & NonKeyAttributes;
+    }
+}

package/dist/db.mjs

@@ -1,4 +1,7 @@
-export const gsi = {
+export const endowGsi = {
     regnumEnv: "regnum-env-gsi",
     slugEnv: "slug-env-gsi",
 };
+export const mediaGsi = {
+    1: "gsi1",
+};

package/dist/index.d.mts

@@ -1,5 +1,13 @@
 import type { Fields as FundItem } from "./cloudsearch.mjs";
-import type { Endow as NEndow } from "./db.mjs";
-export type { Allocation, DonateMethodId, EndowByEinParams, EndowDesignation, EndowQueryParam, EndowsQueryParams, EndowUpdate, Environment, Increment, Milestone, MilestoneUpdate, NewMilestone, NewProgram, Program, ProgramUpdate, SocialMediaURLs, UnSdgNum, } from "./schema.mjs";
+import type { Media, Endow as NEndow } from "./db.mjs";
+export type { Allocation, DonateMethodId, EndowByEinParams, EndowDesignation, EndowQueryParam, EndowsQueryParams, EndowUpdate, Environment, Increment, Milestone, MilestoneUpdate, NewMilestone, NewProgram, Program, ProgramUpdate, SocialMediaURLs, UnSdgNum, MediaQueryParams, MediaType, } from "./schema.mjs";
 export type { FundItem };
-export type Endow = Pick<NEndow.DBRecord, "id" | "slug" | "active_in_countries" | "endow_designation" | "fiscal_sponsored" | "hide_bg_tip" | "hq_country" | "image" | "card_img" | "kyc_donors_only" | "logo" | "name" | "overview" | "published" | "registration_number" | "sdgs" | "social_media_urls" | "street_address" | "tagline" | "url" | "claimed" | "progDonationsAllowed" | "donateMethods" | "allocation" | "increments" | "receiptMsg">;
+export type Endow = Pick<NEndow.DbRecord, "id" | "slug" | "active_in_countries" | "endow_designation" | "fiscal_sponsored" | "hide_bg_tip" | "hq_country" | "image" | "card_img" | "kyc_donors_only" | "logo" | "name" | "overview" | "published" | "registration_number" | "sdgs" | "social_media_urls" | "street_address" | "tagline" | "url" | "claimed" | "progDonationsAllowed" | "donateMethods" | "allocation" | "increments" | "receiptMsg">;
+/** web-app format */
+export type TMedia = Omit<Media.DbRecord, "PK" | "SK" | "gsi1PK" | "gsi1SK"> & {
+    featured: boolean;
+};
+export type MediaPage = {
+    items: TMedia[];
+    nextPageKey?: string;
+};

package/dist/schema.d.mts

@@ -727,3 +727,24 @@ export declare const programUpdate: Omit<Omit<import("valibot").ObjectSchema<{
 export type NewProgram = InferOutput<typeof newProgram>;
 export type Program = InferOutput<typeof program>;
 export type ProgramUpdate = InferOutput<typeof programUpdate>;
+export declare const mediaUrl: import("valibot").SchemaWithPipe<[import("valibot").SchemaWithPipe<[import("valibot").StringSchema<undefined>, import("valibot").TrimAction]>, import("valibot").UrlAction<string, undefined>]>;
+/**
+ * so that media is automatically sorted by date
+ * @see https://github.com/segmentio/ksuid
+ * */
+export declare const mediaKsuid: import("valibot").SchemaWithPipe<[import("valibot").SchemaWithPipe<[import("valibot").StringSchema<undefined>, import("valibot").TrimAction]>, import("valibot").NonEmptyAction<string, undefined>]>;
+export declare const mediaTypes: readonly ["album", "article", "video"];
+export declare const mediaType: import("valibot").PicklistSchema<readonly ["album", "article", "video"], undefined>;
+export type MediaType = InferOutput<typeof mediaType>;
+export declare const mediaUpdate: import("valibot").ObjectSchema<{
+    readonly url: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<[import("valibot").SchemaWithPipe<[import("valibot").StringSchema<undefined>, import("valibot").TrimAction]>, import("valibot").UrlAction<string, undefined>]>, never>;
+    readonly featured: import("valibot").OptionalSchema<import("valibot").BooleanSchema<undefined>, never>;
+}, undefined>;
+export type MediaId = InferOutput<typeof mediaKsuid>;
+export declare const mediaQueryParams: import("valibot").ObjectSchema<{
+    readonly type: import("valibot").PicklistSchema<readonly ["album", "article", "video"], undefined>;
+    readonly nextPageKey: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<[import("valibot").SchemaWithPipe<[import("valibot").StringSchema<undefined>, import("valibot").TrimAction]>, import("valibot").Base64Action<string, undefined>]>, never>;
+    readonly featured: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<[import("valibot").SchemaWithPipe<[import("valibot").StringSchema<undefined>, import("valibot").TrimAction]>, import("valibot").TransformAction<string, boolean>, import("valibot").BooleanSchema<undefined>]>, never>;
+    readonly limit: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<[import("valibot").StringSchema<undefined>, import("valibot").TransformAction<string, number>, import("valibot").NumberSchema<undefined>, import("valibot").IntegerAction<number, undefined>, import("valibot").MinValueAction<number, 1, undefined>]>, never>;
+}, undefined>;
+export type MediaQueryParams = InferInput<typeof mediaQueryParams>;

package/dist/schema.mjs

@@ -1,6 +1,6 @@
 import { env, orgDesignation, unSdgNum } from "@better-giving/schemas";
 export { orgDesignation as endowDesignation, env, unSdgNum };
-import { url, array, boolean, check, custom, excludes, integer, isoDate, keyof, lazy, maxLength, maxValue, minLength, minValue, nonEmpty, nullish, number, object, omit, optional, partial, picklist, pipe, regex, startsWith, string, transform, trim, uuid, } from "valibot";
+import { url, array, base64, boolean, check, custom, excludes, integer, isoDate, keyof, lazy, maxLength, maxValue, minLength, minValue, nonEmpty, nullish, number, object, omit, optional, partial, picklist, pipe, regex, startsWith, string, transform, trim, uuid, } from "valibot";
 export const str = pipe(string(), trim());
 const pct = pipe(number(), integer(), minValue(0), maxValue(100));
 export const allocation = pipe(object({
@@ -131,3 +131,21 @@ export const program = object({
     id: programId,
 });
 export const programUpdate = partial(omit(newProgram, ["milestones"]));
+export const mediaUrl = pipe(str, url());
+/**
+ * so that media is automatically sorted by date
+ * @see https://github.com/segmentio/ksuid
+ * */
+export const mediaKsuid = pipe(str, nonEmpty() /** base62? */);
+export const mediaTypes = ["album", "article", "video"];
+export const mediaType = picklist(mediaTypes);
+export const mediaUpdate = object({
+    url: optional(mediaUrl),
+    featured: optional(boolean()),
+});
+export const mediaQueryParams = object({
+    type: mediaType,
+    nextPageKey: optional(pipe(str, base64())),
+    featured: optional(pipe(str, transform((x) => Boolean(x)), boolean())),
+    limit: optional(pipe(string(), transform((x) => +x), number(), integer(), minValue(1))),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@better-giving/endowment",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "peerDependencies": {
     "@better-giving/schemas": "1.0.1",
     "@better-giving/types": "1.0.1"

package/src/cloudsearch.mts

@@ -6,7 +6,7 @@ import type {
 import type { Endow, Environment } from "./db.mjs";
 
 export type Fields = Pick<
-  Endow.DBRecord,
+  Endow.DbRecord,
   //card UI attribures
   | "card_img"
   | "name"

package/src/index.mts

@@ -1,5 +1,5 @@
 import type { Fields as FundItem } from "./cloudsearch.mjs";
-import type { Endow as NEndow } from "./db.mjs";
+import type { Media, Endow as NEndow } from "./db.mjs";
 export type {
   Allocation,
   DonateMethodId,
@@ -52,3 +52,13 @@ export type Endow = Pick<
   | "increments"
   | "receiptMsg"
 >;
+
+/** web-app format */
+export type TMedia = Omit<Media.DbRecord, "PK" | "SK" | "gsi1PK" | "gsi1SK"> & {
+  featured: boolean;
+};
+
+export type MediaPage = {
+  items: TMedia[];
+  nextPageKey?: string;
+};