@x12i/memorix-service 3.9.2 → 3.11.0

package/dist/analytics/content-allow.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Content types a registered counter may write and read on an existing object type.
+ * The pack allow-list is unchanged. Only `target.contentType` is added, and only
+ * while a non-error counter still materializes into it.
+ */
+type ObjectTypeMeta = {
+    contentTypes: string[];
+};
+export declare function replaceAnalyticsContentGrants(orgId: string, grants: Array<{
+    objectType?: string;
+    contentType?: string;
+}>): void;
+export declare function grantedContentTypes(orgId: string, objectType: string): string[];
+/** Append granted content types. The pack's list, including its first type, stays in front. */
+export declare function mergeGrantedContentTypes<M extends ObjectTypeMeta>(orgId: string, objectType: string, meta: M | null): M | null;
+export {};
+//# sourceMappingURL=content-allow.d.ts.map

package/dist/analytics/content-allow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-allow.d.ts","sourceRoot":"","sources":["../../src/analytics/content-allow.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,KAAK,cAAc,GAAG;IAAE,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAIjD,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,KAAK,CAAC;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC3D,IAAI,CAeN;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAG/E;AAED,+FAA+F;AAC/F,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,cAAc,EAC/D,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,CAAC,GAAG,IAAI,GACb,CAAC,GAAG,IAAI,CAKV"}

package/dist/analytics/content-allow.js

@@ -0,0 +1,39 @@
+/**
+ * Content types a registered counter may write and read on an existing object type.
+ * The pack allow-list is unchanged. Only `target.contentType` is added, and only
+ * while a non-error counter still materializes into it.
+ */
+const byOrg = new Map();
+export function replaceAnalyticsContentGrants(orgId, grants) {
+    const map = new Map();
+    for (const grant of grants) {
+        const objectType = grant.objectType?.trim() ?? "";
+        const contentType = grant.contentType?.trim() ?? "";
+        if (!objectType || !contentType)
+            continue;
+        let set = map.get(objectType);
+        if (!set) {
+            set = new Set();
+            map.set(objectType, set);
+        }
+        set.add(contentType);
+    }
+    if (map.size === 0)
+        byOrg.delete(orgId);
+    else
+        byOrg.set(orgId, map);
+}
+export function grantedContentTypes(orgId, objectType) {
+    const set = byOrg.get(orgId)?.get(objectType);
+    return set ? [...set] : [];
+}
+/** Append granted content types. The pack's list, including its first type, stays in front. */
+export function mergeGrantedContentTypes(orgId, objectType, meta) {
+    if (!meta)
+        return null;
+    const extra = grantedContentTypes(orgId, objectType).filter((ct) => !meta.contentTypes.includes(ct));
+    if (extra.length === 0)
+        return meta;
+    return { ...meta, contentTypes: [...meta.contentTypes, ...extra] };
+}
+//# sourceMappingURL=content-allow.js.map

package/dist/analytics/content-allow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-allow.js","sourceRoot":"","sources":["../../src/analytics/content-allow.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoC,CAAC;AAE1D,MAAM,UAAU,6BAA6B,CAC3C,KAAa,EACb,MAA4D;IAE5D,MAAM,GAAG,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC3C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAClD,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACpD,IAAI,CAAC,UAAU,IAAI,CAAC,WAAW;YAAE,SAAS;QAC1C,IAAI,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC9B,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC3B,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;QAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;;QACnC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,UAAkB;IACnE,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IAC9C,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7B,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,wBAAwB,CACtC,KAAa,EACb,UAAkB,EAClB,IAAc;IAEd,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IACrG,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,EAAE,GAAG,IAAI,EAAE,YAAY,EAAE,CAAC,GAAG,IAAI,CAAC,YAAY,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;AACrE,CAAC"}

package/dist/analytics/definition.d.ts

@@ -0,0 +1,179 @@
+export type AnalyticsPredicate = {
+    property: string;
+    equals?: unknown;
+    in?: unknown[];
+    exists?: boolean;
+};
+export type AnalyticsWhere = AnalyticsPredicate | AnalyticsPredicate[];
+export type AnalyticsWindow = "24h" | "7d" | "30d";
+export type CounterScopeProperty = {
+    key: string;
+    abstractType: string;
+    property: string;
+};
+/**
+ * A selecting node names one population. `abstractType` is the projected abstract.
+ * `objectType` + `contentType` are the stored records; `property` is then a path on
+ * the record (`data.decision`), not an abstract property.
+ */
+export type CounterRecordSelector = {
+    abstractType?: string;
+    objectType?: string;
+    contentType?: string;
+};
+export type CounterMeasure = CounterRecordSelector & {
+    key: string;
+    kind: "count" | "distinct" | "sum" | "mean" | "max";
+    property?: string;
+    where?: AnalyticsWhere;
+    windows?: AnalyticsWindow[];
+};
+export type CounterGroup = CounterRecordSelector & {
+    key: string;
+    property: string;
+    buckets?: string[];
+    subject?: string;
+    where?: AnalyticsWhere;
+    split?: {
+        key: string;
+        property: string;
+        buckets: string[];
+        missing?: string;
+    };
+};
+export type CounterSplit = CounterRecordSelector & {
+    key: string;
+    property: string;
+    buckets: string[];
+    totalKey: string;
+    subsetKey: string;
+    subset: AnalyticsPredicate;
+};
+export type CounterUnwind = {
+    key: string;
+    abstractType: string;
+    arrayProperty: string;
+    columns: Array<{
+        key: string;
+        path: string;
+    }>;
+    aggregates?: Array<{
+        key: string;
+        kind: "count" | "sum" | "max" | "distinct" | "group-count";
+        path?: string;
+        buckets?: string[];
+    }>;
+};
+export type CounterLeaders = {
+    key: string;
+    abstractType: string;
+    idProperty: string;
+    labelProperty: string;
+    limit?: number;
+    countOf?: {
+        abstractType: string;
+        property: string;
+        where?: AnalyticsWhere;
+    };
+    sort?: Array<{
+        property: string;
+        direction?: "asc" | "desc";
+    }>;
+    columns?: Array<{
+        key: string;
+        kind: "value" | "count" | "max" | "sum" | "distinct";
+        property?: string;
+    }>;
+};
+export type CounterDefinition = {
+    id: string;
+    name: string;
+    scope?: [CounterScopeProperty, CounterScopeProperty];
+    clock?: {
+        abstractType: string;
+        property: string;
+    };
+    target: {
+        objectType: string;
+        contentType: string;
+        recordId: string;
+    };
+    history?: {
+        recordId: string;
+        limit?: number;
+    };
+    measures?: CounterMeasure[];
+    groups?: CounterGroup[];
+    ratios?: Array<{
+        key: string;
+        numerator: string;
+        denominator: string;
+    }>;
+    derived?: Array<{
+        key: string;
+        op: "sum" | "difference" | "ratio";
+        terms: string[];
+    }>;
+    splits?: CounterSplit[];
+    unwinds?: CounterUnwind[];
+    leaders?: CounterLeaders[];
+    coverage?: Array<{
+        key: string;
+        abstractType: string;
+        where?: AnalyticsWhere;
+        expected: number | {
+            measure: string;
+        };
+    }>;
+    deltas?: Array<{
+        key: string;
+        measure: string;
+    }>;
+    transitions?: Array<{
+        key: string;
+        abstractType: string;
+        property: string;
+        identityProperty?: string;
+    }>;
+    trends?: Array<{
+        key: string;
+        label: string;
+        measure: string;
+        windows: Array<"snapshots" | "7d" | "30d">;
+    }>;
+};
+export declare const PSEUDO_PROPERTIES: Set<string>;
+export declare function whereList(where: AnalyticsWhere | undefined): AnalyticsPredicate[];
+/** Abstract types whose subjects feed this definition, in declaration order. */
+export declare function abstractTypesOf(def: CounterDefinition): string[];
+/**
+ * Population id for presence, the ledger, and backfill progress.
+ * Abstract populations keep the abstract type id. Stored populations use a reserved prefix.
+ */
+export declare function populationKey(node: CounterRecordSelector): string;
+/** Stored object type + content type pairs a definition counts, in declaration order. */
+export declare function contentSelections(def: CounterDefinition): Array<{
+    objectType: string;
+    contentType: string;
+}>;
+export declare function usesDatasource(def: CounterDefinition): boolean;
+export declare function definitionHash(def: CounterDefinition): string;
+/** What the validator needs to know about installed metadata for the registering scope. */
+export type CounterCatalog = {
+    /** Declared properties with optional enum; null when the abstract type is unknown. */
+    abstractProperties(abstractType: string): Map<string, {
+        enum?: string[];
+    }> | null;
+    hasObjectType(objectType: string): boolean;
+    /** Content types already registered on the object type; null when the object type is unknown. */
+    contentTypes(objectType: string): string[] | null;
+    /** Enum of a declared field path, when that field closes its vocabulary. */
+    fieldEnum(objectType: string, path: string): string[] | null;
+};
+export type CounterValidationIssue = {
+    path: string;
+    code: string;
+    message: string;
+};
+export declare function validateCounterDefinition(raw: unknown, catalog: CounterCatalog): CounterValidationIssue[];
+//# sourceMappingURL=definition.d.ts.map

package/dist/analytics/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/analytics/definition.ts"],"names":[],"mappings":"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"}