@narrative.io/data-collaboration-sdk-ts 2.95.0-beta.0 → 2.95.0

package/build/apps/index.d.ts

@@ -1,5 +1,4 @@
 import { BaseApi } from "../base-api";
-import type { JsonSchemaConnectorPolicy } from "../collaboration-policy/core/jsonschema/json-schema-types";
 import type { ApiRecords } from "../types";
 import type { App, Installation } from "./types";
 /**
@@ -15,11 +14,5 @@ declare class AppsApi extends BaseApi {
      */
     getApps(appCategory?: string): Promise<ApiRecords<App>>;
     getInstalledApps(appCategory?: string): Promise<ApiRecords<Installation>>;
-    /**
-     * Get all interfaces for the current user's installed connectors.
-     * @param {string[]} [tags] - Optional tags to filter interfaces (e.g. ["audience_delivery"]).
-     * @returns {Promise<ApiRecords<JsonSchemaConnectorPolicy>>} - Promise resolving with the list of interfaces.
-     */
-    getInstalledInterfaces(tags?: string[]): Promise<ApiRecords<JsonSchemaConnectorPolicy>>;
 }
 export { type App, type Installation, AppsApi };

package/build/apps/index.js

@@ -21,14 +21,5 @@ class AppsApi extends BaseApi {
         const url = `installations${appCategoryQuery}`;
         return await this.get(url);
     }
-    /**
-     * Get all interfaces for the current user's installed connectors.
-     * @param {string[]} [tags] - Optional tags to filter interfaces (e.g. ["audience_delivery"]).
-     * @returns {Promise<ApiRecords<JsonSchemaConnectorPolicy>>} - Promise resolving with the list of interfaces.
-     */
-    async getInstalledInterfaces(tags) {
-        const queryString = this.constructQueryString(tags != null ? { tags } : undefined);
-        return await this.get(`${resourceName}/installed/interfaces${queryString}`);
-    }
 }
 export { AppsApi };

package/build/collaboration-policy/core/filter-builder.js

@@ -1,12 +1,6 @@
 import { normalizePathValue } from "../utils/path-helpers";
 import { resolveAttributeExpression } from "../utils/sql-helpers";
-function isAttributeReference(node) {
-    return (!!node &&
-        typeof node === "object" &&
-        "type" in node &&
-        node.type === "attribute" &&
-        "attribute_name" in node);
-}
+import { isAttributeReference } from "./filter-utils";
 export function filterToSql(filter, attributeByName, datasetName) {
     const op = filter.op.toLowerCase();
     switch (op) {

package/build/collaboration-policy/core/sql-builder.js

@@ -41,34 +41,30 @@ function parseDurationToMilliseconds(duration) {
  * The smallest duration means the most frequent refresh rate.
  *
  * @param schedules - Array of ISO 8601 duration strings
- * @returns The smallest duration as an ISO 8601 string, or "P1M" (1 month) if no schedules provided
+ * @returns The smallest duration in milliseconds, or 2592000000 (30 days/1 month) if no schedules provided
  */
 function getSmallestRefreshSchedule(schedules) {
-    // Default to monthly
-    const defaultMonthly = "P1M";
+    // Default to monthly (30 days in milliseconds)
+    const defaultMonthlyMs = 30 * 24 * 60 * 60 * 1000;
     if (schedules.length === 0) {
-        return defaultMonthly;
+        return defaultMonthlyMs;
     }
     if (schedules.length === 1) {
         try {
-            // Validate by parsing, but return the original string
-            parseDurationToMilliseconds(schedules[0]);
-            return schedules[0];
+            return parseDurationToMilliseconds(schedules[0]);
         }
         catch (error) {
             console.warn(`Invalid refresh schedule: ${schedules[0]}, using default`, error);
-            return defaultMonthly;
+            return defaultMonthlyMs;
         }
     }
     // Find the schedule with the smallest duration (most frequent refresh)
     let smallestValue = Number.MAX_SAFE_INTEGER;
-    let smallestSchedule = null;
     for (const schedule of schedules) {
         try {
             const value = parseDurationToMilliseconds(schedule);
             if (value < smallestValue) {
                 smallestValue = value;
-                smallestSchedule = schedule;
             }
         }
         catch (error) {
@@ -77,7 +73,9 @@ function getSmallestRefreshSchedule(schedules) {
         }
     }
     // If all schedules failed to parse, return default
-    return smallestSchedule ?? defaultMonthly;
+    return smallestValue === Number.MAX_SAFE_INTEGER
+        ? defaultMonthlyMs
+        : smallestValue;
 }
 /**
  * Builds structured WHERE clauses for a single branch node

package/build/collaboration-policy/core/types.d.ts

@@ -1,91 +1,20 @@
-/**
- * PathValue describes a path to a subfield, expressed as either dot notation
- * or a JSON Pointer. Used in filter attribute references to specify which
- * subfield of an attribute to operate on.
- */
-export type PathValue = {
-    dot: string;
-} | {
-    pointer: string;
-};
-/**
- * An attribute reference within a filter expression.
- */
-export interface FilterAttributeRef {
-    type: "attribute";
-    attribute_name: string;
-    path?: PathValue;
-}
-/**
- * A filter expression: a literal value or an attribute reference.
- */
-export type FilterExpression = string | number | boolean | FilterAttributeRef;
-/**
- * PolicyFilter is a single filter entry in a policy definition.
- *
- * This is the canonical filter type used across the codebase (JSON-Schema
- * filters, SQL builder, etc.).
- */
-export type PolicyFilter = PolicyFilterAndOr | PolicyFilterNot | PolicyFilterIsNull | PolicyFilterIn | PolicyFilterCompare | PolicyFilterBetween;
-interface PolicyFilterBase {
-    stage?: "generation";
-    name?: string;
-    required?: boolean;
-}
-interface PolicyFilterAndOr extends PolicyFilterBase {
-    op: "and" | "or";
-    args: FilterExpression[];
-}
-interface PolicyFilterNot extends PolicyFilterBase {
-    op: "not";
-    args: FilterExpression[];
-}
-interface PolicyFilterIsNull extends PolicyFilterBase {
-    op: "is_null" | "is_not_null";
-    left: FilterExpression;
-}
-interface PolicyFilterIn extends PolicyFilterBase {
-    op: "in" | "not in";
-    left: FilterExpression;
-    right: FilterExpression[];
-}
-interface PolicyFilterCompare extends PolicyFilterBase {
-    op: "=" | "<>" | ">" | ">=" | "<" | "<=" | "like" | "not like";
-    left: FilterExpression;
-    right: FilterExpression;
-}
-interface PolicyFilterBetween extends PolicyFilterBase {
-    op: "between";
-    operand: FilterExpression;
-    lower: FilterExpression;
-    upper: FilterExpression;
-}
-/**
- * Map from attribute name -> set of normalized paths that must be selected
- * for SQL generation.
- */
+import type { CollaborationPolicyType } from "../types";
+type PolicyDefinition = CollaborationPolicyType["policy"]["definition"];
+export type StructureNode = PolicyDefinition["structure"];
+export type ExtendedAttributeNode = Extract<StructureNode, {
+    field: unknown;
+}>;
+export type PolicyFilter = NonNullable<PolicyDefinition["filters"]>[number];
+export type PathValue = NonNullable<ExtendedAttributeNode["field"]["additional_required_properties"]>[number];
 export type AttributePathIndex = Map<string, Set<string>>;
-/**
- * A logical group of SQL fragments combined by an operation.
- */
 export interface PolicySqlGroup {
     fragments: Array<string | PolicySqlGroup>;
     operation: "AND" | "OR";
 }
-/**
- * Core SQL fragments required to represent a set of collaboration policies.
- */
 export interface PolicySqlFragments {
     select: string[];
     where: Array<PolicySqlGroup | string>;
 }
-/**
- * Full result of applying collaboration policies to a dataset, including:
- * - which policies were applied
- * - which were skipped and why
- * - warnings
- * - the minimum refresh schedule across applied policies
- */
 export interface PolicyMatchResult extends PolicySqlFragments {
     appliedPolicies: string[];
     skippedPolicies: Array<{
@@ -94,7 +23,7 @@ export interface PolicyMatchResult extends PolicySqlFragments {
         details: string[];
     }>;
     warnings: string[];
-    /** The minimum refresh schedule as an ISO 8601 duration string across all evaluated policies */
-    refresh_schedule: string;
+    /** The minimum refresh schedule in milliseconds across all evaluated policies */
+    refresh_schedule: number;
 }
 export {};

package/build/collaboration-policy/index.d.ts

@@ -1,5 +1,4 @@
-export type { JsonSchemaConnectorPolicy } from "./core/jsonschema/json-schema-types";
-export { evaluateJsonSchemaPolicies } from "./core/jsonschema/policy-evaluator";
-export { buildPolicySql, buildPolicySqlWithJsonSchema, buildPolicySqlWithValidation, categorizePolicies, type JsonSchemaPolicyMatchResult, } from "./core/jsonschema/sql-builder";
-export type { AttributePathIndex, FilterAttributeRef, FilterExpression, PathValue, PolicyFilter, PolicyMatchResult, PolicySqlFragments, PolicySqlGroup, } from "./core/types";
-export { default as useCollaborationPolicy } from "./useCollaborationPolicy";
+export { buildPolicySql, buildPolicySqlWithValidation, categorizePolicies, } from "./core/sql-builder";
+export type { AttributePathIndex, ExtendedAttributeNode, PathValue, PolicyFilter, PolicyMatchResult, PolicySqlFragments, PolicySqlGroup, StructureNode, } from "./core/types";
+export type { CollaborationPolicyInput, CollaborationPolicyType, } from "./types";
+export { buildCollaborationPolicyJsonSchema, CollaborationPolicy, } from "./types";

package/build/collaboration-policy/index.js

@@ -1,4 +1,3 @@
-export { evaluateJsonSchemaPolicies } from "./core/jsonschema/policy-evaluator";
-export { buildPolicySql, buildPolicySqlWithJsonSchema, buildPolicySqlWithValidation, categorizePolicies, } from "./core/jsonschema/sql-builder";
-// Hook-style entrypoint
-export { default as useCollaborationPolicy } from "./useCollaborationPolicy";
+// Export the main functions
+export { buildPolicySql, buildPolicySqlWithValidation, categorizePolicies, } from "./core/sql-builder";
+export { buildCollaborationPolicyJsonSchema, CollaborationPolicy, } from "./types";