@investment-finder/api-contract 0.4.0 → 0.6.0

package/dist/market-edition-slug.d.ts

@@ -0,0 +1,22 @@
+export type MarketEditionKind = 'brief' | 'newsletter';
+export type MarketEditionVariant = 'daily' | 'weekly';
+export interface IMarketEditionSlugParts {
+    kind: MarketEditionKind;
+    variant: MarketEditionVariant;
+    snapshotDate: string;
+}
+/**
+ * Builds a stable URL slug from edition kind, variant, and snapshot date.
+ * Example: daily + brief + 2026-07-31 → daily-brief-2026-07-31
+ */
+export declare function buildMarketEditionSlug(kind: MarketEditionKind, variant: string, snapshotDate: string): string;
+/**
+ * Builds the human-readable edition name used in UI and routing examples.
+ * Example: Daily Brief 2026-07-31
+ */
+export declare function buildMarketEditionName(kind: MarketEditionKind, variant: string, snapshotDate: string): string;
+/**
+ * Parses a market edition slug into kind, variant, and snapshot date.
+ */
+export declare function parseMarketEditionSlug(slug: string): IMarketEditionSlugParts | null;
+//# sourceMappingURL=market-edition-slug.d.ts.map

package/dist/market-edition-slug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"market-edition-slug.d.ts","sourceRoot":"","sources":["../src/market-edition-slug.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,YAAY,CAAC;AAEvD,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;CACtB;AAMD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB,MAAM,CASR;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB,MAAM,CAaR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,GACX,uBAAuB,GAAG,IAAI,CAYhC"}

package/dist/market-edition-slug.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildMarketEditionSlug = buildMarketEditionSlug;
+exports.buildMarketEditionName = buildMarketEditionName;
+exports.parseMarketEditionSlug = parseMarketEditionSlug;
+const SNAPSHOT_DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+const MARKET_EDITION_SLUG_PATTERN = /^(daily|weekly)-(brief|newsletter)-(\d{4}-\d{2}-\d{2})$/;
+/**
+ * Builds a stable URL slug from edition kind, variant, and snapshot date.
+ * Example: daily + brief + 2026-07-31 → daily-brief-2026-07-31
+ */
+function buildMarketEditionSlug(kind, variant, snapshotDate) {
+    const normalizedVariant = normalizeEditionVariant(variant);
+    if (normalizedVariant === null || !SNAPSHOT_DATE_PATTERN.test(snapshotDate)) {
+        throw new Error(`Invalid market edition slug inputs: ${variant} ${snapshotDate}`);
+    }
+    return `${normalizedVariant}-${kind}-${snapshotDate}`;
+}
+/**
+ * Builds the human-readable edition name used in UI and routing examples.
+ * Example: Daily Brief 2026-07-31
+ */
+function buildMarketEditionName(kind, variant, snapshotDate) {
+    const normalizedVariant = normalizeEditionVariant(variant);
+    if (normalizedVariant === null || !SNAPSHOT_DATE_PATTERN.test(snapshotDate)) {
+        throw new Error(`Invalid market edition name inputs: ${variant} ${snapshotDate}`);
+    }
+    const variantLabel = normalizedVariant === 'weekly' ? 'Weekly' : 'Daily';
+    const kindLabel = kind === 'newsletter' ? 'Newsletter' : 'Brief';
+    return `${variantLabel} ${kindLabel} ${snapshotDate}`;
+}
+/**
+ * Parses a market edition slug into kind, variant, and snapshot date.
+ */
+function parseMarketEditionSlug(slug) {
+    const trimmed = slug.trim().toLowerCase();
+    const match = MARKET_EDITION_SLUG_PATTERN.exec(trimmed);
+    if (match === null) {
+        return null;
+    }
+    return {
+        variant: match[1],
+        kind: match[2],
+        snapshotDate: match[3],
+    };
+}
+function normalizeEditionVariant(variant) {
+    const normalized = variant.trim().toLowerCase();
+    if (normalized === 'daily' || normalized === 'weekly') {
+        return normalized;
+    }
+    return null;
+}
+//# sourceMappingURL=market-edition-slug.js.map

package/dist/market-edition-slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"market-edition-slug.js","sourceRoot":"","sources":["../src/market-edition-slug.ts"],"names":[],"mappings":";;AAkBA,wDAaC;AAMD,wDAiBC;AAKD,wDAcC;AA/DD,MAAM,qBAAqB,GAAG,qBAAqB,CAAC;AACpD,MAAM,2BAA2B,GAC/B,yDAAyD,CAAC;AAE5D;;;GAGG;AACH,SAAgB,sBAAsB,CACpC,IAAuB,EACvB,OAAe,EACf,YAAoB;IAEpB,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAC3D,IAAI,iBAAiB,KAAK,IAAI,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CACb,uCAAuC,OAAO,IAAI,YAAY,EAAE,CACjE,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,iBAAiB,IAAI,IAAI,IAAI,YAAY,EAAE,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,SAAgB,sBAAsB,CACpC,IAAuB,EACvB,OAAe,EACf,YAAoB;IAEpB,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAC3D,IAAI,iBAAiB,KAAK,IAAI,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CACb,uCAAuC,OAAO,IAAI,YAAY,EAAE,CACjE,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAChB,iBAAiB,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;IACtD,MAAM,SAAS,GAAG,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC;IAEjE,OAAO,GAAG,YAAY,IAAI,SAAS,IAAI,YAAY,EAAE,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CACpC,IAAY;IAEZ,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAG,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,CAAC,CAAyB;QACzC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAsB;QACnC,YAAY,EAAE,KAAK,CAAC,CAAC,CAAE;KACxB,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,OAAe;IAC9C,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChD,IAAI,UAAU,KAAK,OAAO,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QACtD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}