@narrative.io/data-collaboration-sdk-ts 2.68.0 → 2.84.0

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

@@ -12,36 +12,70 @@ function buildAttributeIndexes(attributes) {
     }
     return { byId, byName };
 }
+/**
+ * Converts an ISO 8601 duration string to milliseconds for comparison.
+ * This is an approximation for human-readable durations (months/years vary in length).
+ *
+ * @param duration - ISO 8601 duration string (e.g., "PT1H", "P1D", "P1M")
+ * @returns Duration in milliseconds
+ */
+function parseDurationToMilliseconds(duration) {
+    const regex = /^P(?:(\d+)Y)?(?:(\d+)M)?(?:(\d+)W)?(?:(\d+)D)?(?:T(?:(\d+)H)?(?:(\d+)M)?(?:(\d+)S)?)?$/;
+    const matches = duration.match(regex);
+    if (!matches) {
+        throw new Error(`Invalid ISO 8601 duration format: ${duration}`);
+    }
+    const [, years, months, weeks, days, hours, minutes, seconds] = matches.map((m) => Number.parseInt(m || "0", 10));
+    // Approximate conversions (months = 30 days, years = 365 days)
+    const milliseconds = years * 365 * 24 * 60 * 60 * 1000 +
+        months * 30 * 24 * 60 * 60 * 1000 +
+        weeks * 7 * 24 * 60 * 60 * 1000 +
+        days * 24 * 60 * 60 * 1000 +
+        hours * 60 * 60 * 1000 +
+        minutes * 60 * 1000 +
+        seconds * 1000;
+    return milliseconds;
+}
+/**
+ * Finds the smallest (most frequent) refresh schedule from a list of ISO 8601 duration strings.
+ * The smallest duration means the most frequent refresh rate.
+ *
+ * @param schedules - Array of ISO 8601 duration strings
+ * @returns The smallest duration in milliseconds, or 2592000000 (30 days/1 month) if no schedules provided
+ */
 function getSmallestRefreshSchedule(schedules) {
+    // Default to monthly (30 days in milliseconds)
+    const defaultMonthlyMs = 30 * 24 * 60 * 60 * 1000;
     if (schedules.length === 0) {
-        return "@monthly";
+        return defaultMonthlyMs;
     }
-    // Define the hierarchy for refresh schedules (from smallest to largest)
-    const scheduleHierarchy = {
-        "@once": 0,
-        "@hourly": 1,
-        "@daily": 2,
-        "@weekly": 3,
-        "@monthly": 4,
-    };
-    // Find the schedule with the smallest value (most frequent)
-    let smallestSchedule = "@monthly";
-    let smallestValue = scheduleHierarchy["@monthly"];
+    if (schedules.length === 1) {
+        try {
+            return parseDurationToMilliseconds(schedules[0]);
+        }
+        catch (error) {
+            console.warn(`Invalid refresh schedule: ${schedules[0]}, using default`, error);
+            return defaultMonthlyMs;
+        }
+    }
+    // Find the schedule with the smallest duration (most frequent refresh)
+    let smallestValue = Number.MAX_SAFE_INTEGER;
     for (const schedule of schedules) {
-        if (schedule in scheduleHierarchy) {
-            const value = scheduleHierarchy[schedule];
+        try {
+            const value = parseDurationToMilliseconds(schedule);
             if (value < smallestValue) {
                 smallestValue = value;
-                smallestSchedule = schedule;
             }
         }
-        else {
-            // If it's a custom cron expression, treat it as the most frequent (smallest)
-            // since we can't easily compare cron expressions
-            return schedule;
+        catch (error) {
+            // If parsing fails, skip this schedule
+            console.warn(`Skipping invalid refresh schedule: ${schedule}`, error);
         }
     }
-    return smallestSchedule;
+    // If all schedules failed to parse, return default
+    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

@@ -23,6 +23,7 @@ export interface PolicyMatchResult extends PolicySqlFragments {
         details: string[];
     }>;
     warnings: string[];
-    refresh_schedule: string;
+    /** The minimum refresh schedule in milliseconds across all evaluated policies */
+    refresh_schedule: number;
 }
 export {};

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

@@ -12,13 +12,7 @@ declare const CollaborationPolicy: z.ZodObject<{
         metadata: z.ZodObject<{
             tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             refresh_schedule: z.ZodOptional<z.ZodObject<{
-                max: z.ZodUnion<readonly [z.ZodEnum<{
-                    "@hourly": "@hourly";
-                    "@daily": "@daily";
-                    "@weekly": "@weekly";
-                    "@monthly": "@monthly";
-                    "@once": "@once";
-                }>, z.ZodString]>;
+                max: z.ZodString;
             }, z.core.$strict>>;
         }, z.core.$strip>;
         definition: z.ZodObject<{

package/build/collaboration-policy/types/collaboration-policy.js

@@ -7,15 +7,27 @@ const CollaborationPolicyIdentifier = z
     .meta({
     id: "collaboration_policy_identifier",
 });
-/** Refresh Schedule Schema */
+/**
+ * Refresh Schedule Schema
+ *
+ * Specifies how often the destination should be refreshed to ensure data doesn't expire.
+ * This is the maximum time interval allowed between destination updates. Waiting longer
+ * than this duration may result in the destination expiring data that should be retained.
+ *
+ * Uses ISO 8601 duration format (e.g., "PT1H" for 1 hour, "P1D" for 1 day).
+ * Supported values:
+ * - PT1H: Hourly (1 hour)
+ * - P1D: Daily (1 day)
+ * - P7D: Weekly (7 days)
+ * - P1M: Monthly (1 month)
+ * - P0D: Once (no recurring refresh)
+ * - Custom ISO 8601 duration strings (e.g., "PT30M" for 30 minutes, "P2W" for 2 weeks)
+ */
 const RefreshScheduleSchema = z
     .object({
-    max: z.union([
-        z.enum(["@hourly", "@daily", "@weekly", "@monthly", "@once"]),
-        z
-            .string()
-            .regex(/^([0-5]?[0-9]|\*) ([01]?[0-9]|2[0-3]|\*) ([0-2]?[0-9]|3[01]|\*) ([0]?[1-9]|1[0-2]|\*) ([0-6]|\*)$/, "Invalid cron expression"),
-    ]),
+    max: z
+        .string()
+        .regex(/^P(?!$)(\d+Y)?(\d+M)?(\d+W)?(\d+D)?(T(?=\d)(\d+H)?(\d+M)?(\d+S)?)?$/, "Invalid ISO 8601 duration format. Expected format like 'PT1H' (1 hour), 'P1D' (1 day), 'P7D' (7 days), 'P1M' (1 month), or 'P0D' (once)"),
 })
     .strict()
     .meta({

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@narrative.io/data-collaboration-sdk-ts",
-	"version": "2.68.0",
+	"version": "2.84.0",
 	"main": "build/index.js",
 	"repository": "github:narrative-io/data-collaboration-sdk-ts",
 	"source": "src/index.ts",
@@ -27,18 +27,18 @@
 		"@babel/core": "7.28.4",
 		"@babel/preset-env": "7.28.3",
 		"@babel/preset-typescript": "7.27.1",
-		"@biomejs/biome": "2.2.5",
+		"@biomejs/biome": "2.2.7",
 		"@commitlint/cli": "20.1.0",
 		"@commitlint/config-conventional": "20.0.0",
 		"@types/jest": "30.0.0",
 		"babel-jest": "30.2.0",
 		"jest": "30.2.0",
-		"lefthook": "1.13.6",
-		"ts-jest": "29.4.4"
+		"lefthook": "2.0.0",
+		"ts-jest": "29.4.5"
 	},
 	"dependencies": {
 		"mande": "2.0.9",
-		"zod": "4.1.11",
+		"zod": "4.1.12",
 		"bignumber.js": "9.3.1"
 	},
 	"overrides": {