@etohq/utils 1.5.1-alpha.2 → 1.5.1-alpha.4

package/dist/zod/schemas/clicks.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clickEventResponseSchema = exports.linkEventSchema = exports.clickEventSchema = exports.clickEventSchemaTB = void 0;
+const zod_1 = require("zod");
+// Access link click event schema for Tinybird (following Dub's clickEventSchemaTB pattern exactly)
+exports.clickEventSchemaTB = zod_1.z.object({
+    timestamp: zod_1.z.string(),
+    identity_hash: zod_1.z.string(), // Following Dub's pattern for anonymous tracking
+    click_id: zod_1.z.string(), // Keep Dub's naming
+    link_id: zod_1.z.string(),
+    url: zod_1.z.string(),
+    continent: zod_1.z.string().nullable(),
+    country: zod_1.z.string().nullable(),
+    region: zod_1.z.string().nullable(),
+    city: zod_1.z.string().nullable(),
+    latitude: zod_1.z.string().nullable(),
+    longitude: zod_1.z.string().nullable(),
+    device: zod_1.z.string().nullable(),
+    device_model: zod_1.z.string().nullable(),
+    device_vendor: zod_1.z.string().nullable(),
+    browser: zod_1.z.string().nullable(),
+    browser_version: zod_1.z.string().nullable(),
+    os: zod_1.z.string().nullable(),
+    os_version: zod_1.z.string().nullable(),
+    trigger: zod_1.z.string().nullish(), // backwards compatibility
+    engine: zod_1.z.string().nullable(),
+    engine_version: zod_1.z.string().nullable(),
+    cpu_architecture: zod_1.z.string().nullable(),
+    ua: zod_1.z.string().nullable(),
+    bot: zod_1.z.number().nullable(),
+    referer: zod_1.z.string().nullable(),
+    referer_url: zod_1.z.string().nullable(),
+    ip: zod_1.z.string().nullable(),
+    qr: zod_1.z.number().nullable(),
+    // ETO additions to click data
+    user_id: zod_1.z.string().nullable(), // ETO: track user who clicked
+    project_id: zod_1.z.string().nullable(), // ETO: project context
+});
+// Access link event schema (API response)
+exports.clickEventSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    timestamp: zod_1.z.coerce.date(),
+    url: zod_1.z.string(),
+    country: zod_1.z.string(),
+    city: zod_1.z.string(),
+    region: zod_1.z.string(),
+    continent: zod_1.z.string(),
+    device: zod_1.z.string(),
+    browser: zod_1.z.string(),
+    os: zod_1.z.string(),
+    trigger: zod_1.z.string().nullish(),
+    referer: zod_1.z.string(),
+    refererUrl: zod_1.z.string(),
+    qr: zod_1.z.coerce.boolean(),
+    ip: zod_1.z.string(),
+});
+// Link event schema (matching ETO AccessLinkDTO structure)
+exports.linkEventSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    domain: zod_1.z.string(),
+    key: zod_1.z.string(),
+    url: zod_1.z.string(),
+    short_link: zod_1.z.string(),
+    project_id: zod_1.z.string(),
+    target_resource_type: zod_1.z.string().nullable(),
+    target_resource_id: zod_1.z.string().nullable(),
+    access_role: zod_1.z.string().nullable(),
+    max_uses: zod_1.z.number().nullable(),
+    current_uses: zod_1.z.number(),
+    expires_at: zod_1.z.date().nullable(),
+    creator_user_id: zod_1.z.string(),
+    purpose: zod_1.z.string(),
+    auto_approve: zod_1.z.boolean(),
+    requires_approval: zod_1.z.boolean(),
+    password_protected: zod_1.z.boolean(),
+    created_at: zod_1.z.date(),
+});
+// API response schema (following Dub's pattern)
+exports.clickEventResponseSchema = zod_1.z.object({
+    event: zod_1.z.literal("click"),
+    timestamp: zod_1.z.coerce.string(),
+    click: exports.clickEventSchema,
+    link: exports.linkEventSchema,
+});
+//# sourceMappingURL=clicks.js.map

package/dist/zod/schemas/clicks.js.map

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

package/dist/zod/schemas/leads.d.ts

@@ -0,0 +1,423 @@
+import { z } from "zod";
+export declare const CustomerSchema: z.ZodObject<{
+    id: z.ZodString;
+    externalId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    country: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    externalId?: string | null | undefined;
+    name?: string | null | undefined;
+    email?: string | null | undefined;
+    avatar?: string | null | undefined;
+    country?: string | null | undefined;
+}, {
+    id: string;
+    externalId?: string | null | undefined;
+    name?: string | null | undefined;
+    email?: string | null | undefined;
+    avatar?: string | null | undefined;
+    country?: string | null | undefined;
+}>;
+export declare const leadEventSchemaTB: z.ZodObject<{
+    qr: z.ZodNullable<z.ZodNumber>;
+    bot: z.ZodNullable<z.ZodNumber>;
+    continent: z.ZodNullable<z.ZodString>;
+    country: z.ZodNullable<z.ZodString>;
+    region: z.ZodNullable<z.ZodString>;
+    city: z.ZodNullable<z.ZodString>;
+    latitude: z.ZodNullable<z.ZodString>;
+    longitude: z.ZodNullable<z.ZodString>;
+    url: z.ZodString;
+    trigger: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    ip: z.ZodNullable<z.ZodString>;
+    referer: z.ZodNullable<z.ZodString>;
+    click_id: z.ZodString;
+    link_id: z.ZodString;
+    user_id: z.ZodNullable<z.ZodString>;
+    project_id: z.ZodNullable<z.ZodString>;
+    identity_hash: z.ZodString;
+    device: z.ZodNullable<z.ZodString>;
+    device_model: z.ZodNullable<z.ZodString>;
+    device_vendor: z.ZodNullable<z.ZodString>;
+    browser: z.ZodNullable<z.ZodString>;
+    browser_version: z.ZodNullable<z.ZodString>;
+    os: z.ZodNullable<z.ZodString>;
+    os_version: z.ZodNullable<z.ZodString>;
+    engine: z.ZodNullable<z.ZodString>;
+    engine_version: z.ZodNullable<z.ZodString>;
+    cpu_architecture: z.ZodNullable<z.ZodString>;
+    ua: z.ZodNullable<z.ZodString>;
+    referer_url: z.ZodNullable<z.ZodString>;
+    event_id: z.ZodString;
+    event_name: z.ZodString;
+    customer_id: z.ZodDefault<z.ZodString>;
+    metadata: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    qr: number | null;
+    bot: number | null;
+    continent: string | null;
+    country: string | null;
+    region: string | null;
+    city: string | null;
+    latitude: string | null;
+    longitude: string | null;
+    url: string;
+    ip: string | null;
+    referer: string | null;
+    metadata: string;
+    click_id: string;
+    link_id: string;
+    user_id: string | null;
+    project_id: string | null;
+    event_id: string;
+    event_name: string;
+    customer_id: string;
+    identity_hash: string;
+    device: string | null;
+    device_model: string | null;
+    device_vendor: string | null;
+    browser: string | null;
+    browser_version: string | null;
+    os: string | null;
+    os_version: string | null;
+    engine: string | null;
+    engine_version: string | null;
+    cpu_architecture: string | null;
+    ua: string | null;
+    referer_url: string | null;
+    trigger?: string | null | undefined;
+}, {
+    qr: number | null;
+    bot: number | null;
+    continent: string | null;
+    country: string | null;
+    region: string | null;
+    city: string | null;
+    latitude: string | null;
+    longitude: string | null;
+    url: string;
+    ip: string | null;
+    referer: string | null;
+    click_id: string;
+    link_id: string;
+    user_id: string | null;
+    project_id: string | null;
+    event_id: string;
+    event_name: string;
+    identity_hash: string;
+    device: string | null;
+    device_model: string | null;
+    device_vendor: string | null;
+    browser: string | null;
+    browser_version: string | null;
+    os: string | null;
+    os_version: string | null;
+    engine: string | null;
+    engine_version: string | null;
+    cpu_architecture: string | null;
+    ua: string | null;
+    referer_url: string | null;
+    trigger?: string | null | undefined;
+    customer_id?: string | undefined;
+    metadata?: string | undefined;
+}>;
+export declare const leadEventSchemaTBEndpoint: z.ZodObject<{
+    event: z.ZodLiteral<"lead">;
+    timestamp: z.ZodString;
+    event_id: z.ZodString;
+    event_name: z.ZodString;
+    customer_id: z.ZodString;
+    click_id: z.ZodString;
+    link_id: z.ZodString;
+    url: z.ZodString;
+    continent: z.ZodNullable<z.ZodString>;
+    country: z.ZodNullable<z.ZodString>;
+    region: z.ZodNullable<z.ZodString>;
+    city: z.ZodNullable<z.ZodString>;
+    device: z.ZodNullable<z.ZodString>;
+    browser: z.ZodNullable<z.ZodString>;
+    os: z.ZodNullable<z.ZodString>;
+    referer: z.ZodNullable<z.ZodString>;
+    referer_url: z.ZodNullable<z.ZodString>;
+    metadata: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    continent: string | null;
+    country: string | null;
+    region: string | null;
+    city: string | null;
+    url: string;
+    timestamp: string;
+    referer: string | null;
+    metadata: string;
+    click_id: string;
+    link_id: string;
+    event_id: string;
+    event_name: string;
+    customer_id: string;
+    event: "lead";
+    device: string | null;
+    browser: string | null;
+    os: string | null;
+    referer_url: string | null;
+}, {
+    continent: string | null;
+    country: string | null;
+    region: string | null;
+    city: string | null;
+    url: string;
+    timestamp: string;
+    referer: string | null;
+    metadata: string;
+    click_id: string;
+    link_id: string;
+    event_id: string;
+    event_name: string;
+    customer_id: string;
+    event: "lead";
+    device: string | null;
+    browser: string | null;
+    os: string | null;
+    referer_url: string | null;
+}>;
+export declare const leadEventResponseSchema: z.ZodObject<{
+    event: z.ZodLiteral<"lead">;
+    timestamp: z.ZodString;
+    eventId: z.ZodString;
+    eventName: z.ZodString;
+    metadata: z.ZodOptional<z.ZodNullable<z.ZodAny>>;
+    click: z.ZodObject<{
+        id: z.ZodString;
+        timestamp: z.ZodDate;
+        url: z.ZodString;
+        country: z.ZodString;
+        city: z.ZodString;
+        region: z.ZodString;
+        continent: z.ZodString;
+        device: z.ZodString;
+        browser: z.ZodString;
+        os: z.ZodString;
+        trigger: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        referer: z.ZodString;
+        refererUrl: z.ZodString;
+        qr: z.ZodBoolean;
+        ip: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        qr: boolean;
+        continent: string;
+        country: string;
+        region: string;
+        city: string;
+        url: string;
+        timestamp: Date;
+        ip: string;
+        referer: string;
+        device: string;
+        browser: string;
+        os: string;
+        id: string;
+        refererUrl: string;
+        trigger?: string | null | undefined;
+    }, {
+        qr: boolean;
+        continent: string;
+        country: string;
+        region: string;
+        city: string;
+        url: string;
+        timestamp: Date;
+        ip: string;
+        referer: string;
+        device: string;
+        browser: string;
+        os: string;
+        id: string;
+        refererUrl: string;
+        trigger?: string | null | undefined;
+    }>;
+    link: z.ZodObject<{
+        id: z.ZodString;
+        domain: z.ZodString;
+        key: z.ZodString;
+        url: z.ZodString;
+        short_link: z.ZodString;
+        project_id: z.ZodString;
+        target_resource_type: z.ZodNullable<z.ZodString>;
+        target_resource_id: z.ZodNullable<z.ZodString>;
+        access_role: z.ZodNullable<z.ZodString>;
+        max_uses: z.ZodNullable<z.ZodNumber>;
+        current_uses: z.ZodNumber;
+        expires_at: z.ZodNullable<z.ZodDate>;
+        creator_user_id: z.ZodString;
+        purpose: z.ZodString;
+        auto_approve: z.ZodBoolean;
+        requires_approval: z.ZodBoolean;
+        password_protected: z.ZodBoolean;
+        created_at: z.ZodDate;
+    }, "strip", z.ZodTypeAny, {
+        domain: string;
+        key: string;
+        url: string;
+        project_id: string;
+        short_link: string;
+        target_resource_type: string | null;
+        target_resource_id: string | null;
+        access_role: string | null;
+        max_uses: number | null;
+        current_uses: number;
+        expires_at: Date | null;
+        creator_user_id: string;
+        purpose: string;
+        auto_approve: boolean;
+        requires_approval: boolean;
+        password_protected: boolean;
+        created_at: Date;
+        id: string;
+    }, {
+        domain: string;
+        key: string;
+        url: string;
+        project_id: string;
+        short_link: string;
+        target_resource_type: string | null;
+        target_resource_id: string | null;
+        access_role: string | null;
+        max_uses: number | null;
+        current_uses: number;
+        expires_at: Date | null;
+        creator_user_id: string;
+        purpose: string;
+        auto_approve: boolean;
+        requires_approval: boolean;
+        password_protected: boolean;
+        created_at: Date;
+        id: string;
+    }>;
+    customer: z.ZodObject<{
+        id: z.ZodString;
+        externalId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        country: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        externalId?: string | null | undefined;
+        name?: string | null | undefined;
+        email?: string | null | undefined;
+        avatar?: string | null | undefined;
+        country?: string | null | undefined;
+    }, {
+        id: string;
+        externalId?: string | null | undefined;
+        name?: string | null | undefined;
+        email?: string | null | undefined;
+        avatar?: string | null | undefined;
+        country?: string | null | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    link: {
+        domain: string;
+        key: string;
+        url: string;
+        project_id: string;
+        short_link: string;
+        target_resource_type: string | null;
+        target_resource_id: string | null;
+        access_role: string | null;
+        max_uses: number | null;
+        current_uses: number;
+        expires_at: Date | null;
+        creator_user_id: string;
+        purpose: string;
+        auto_approve: boolean;
+        requires_approval: boolean;
+        password_protected: boolean;
+        created_at: Date;
+        id: string;
+    };
+    eventName: string;
+    eventId: string;
+    event: "lead";
+    click: {
+        qr: boolean;
+        continent: string;
+        country: string;
+        region: string;
+        city: string;
+        url: string;
+        timestamp: Date;
+        ip: string;
+        referer: string;
+        device: string;
+        browser: string;
+        os: string;
+        id: string;
+        refererUrl: string;
+        trigger?: string | null | undefined;
+    };
+    customer: {
+        id: string;
+        externalId?: string | null | undefined;
+        name?: string | null | undefined;
+        email?: string | null | undefined;
+        avatar?: string | null | undefined;
+        country?: string | null | undefined;
+    };
+    metadata?: any;
+}, {
+    timestamp: string;
+    link: {
+        domain: string;
+        key: string;
+        url: string;
+        project_id: string;
+        short_link: string;
+        target_resource_type: string | null;
+        target_resource_id: string | null;
+        access_role: string | null;
+        max_uses: number | null;
+        current_uses: number;
+        expires_at: Date | null;
+        creator_user_id: string;
+        purpose: string;
+        auto_approve: boolean;
+        requires_approval: boolean;
+        password_protected: boolean;
+        created_at: Date;
+        id: string;
+    };
+    eventName: string;
+    eventId: string;
+    event: "lead";
+    click: {
+        qr: boolean;
+        continent: string;
+        country: string;
+        region: string;
+        city: string;
+        url: string;
+        timestamp: Date;
+        ip: string;
+        referer: string;
+        device: string;
+        browser: string;
+        os: string;
+        id: string;
+        refererUrl: string;
+        trigger?: string | null | undefined;
+    };
+    customer: {
+        id: string;
+        externalId?: string | null | undefined;
+        name?: string | null | undefined;
+        email?: string | null | undefined;
+        avatar?: string | null | undefined;
+        country?: string | null | undefined;
+    };
+    metadata?: any;
+}>;
+//# sourceMappingURL=leads.d.ts.map

package/dist/zod/schemas/leads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leads.d.ts","sourceRoot":"","sources":["../../../src/zod/schemas/leads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;EAOzB,CAAA;AAGF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS3B,CAAA;AAGH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBpC,CAAA;AAGF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWlC,CAAA"}

package/dist/zod/schemas/leads.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.leadEventResponseSchema = exports.leadEventSchemaTBEndpoint = exports.leadEventSchemaTB = exports.CustomerSchema = void 0;
+const zod_1 = require("zod");
+const clicks_1 = require("./clicks");
+// ETO Customer schema (adapted from Dub's CustomerSchema for our user model)
+exports.CustomerSchema = zod_1.z.object({
+    id: zod_1.z.string().describe("The unique ID of the user in ETO system"),
+    externalId: zod_1.z.string().nullish().describe("External identifier for the user"),
+    name: zod_1.z.string().nullish().describe("Name of the user"),
+    email: zod_1.z.string().nullish().describe("Email of the user"),
+    avatar: zod_1.z.string().nullish().describe("Avatar URL of the user"),
+    country: zod_1.z.string().nullish().describe("Country of the user"),
+});
+// Access grant event schema for Tinybird (following Dub's leadEventSchemaTB pattern)
+exports.leadEventSchemaTB = clicks_1.clickEventSchemaTB
+    .omit({ timestamp: true }) // remove timestamp from lead data because tinybird will generate its own at ingestion time
+    .merge(zod_1.z.object({
+    event_id: zod_1.z.string(),
+    event_name: zod_1.z.string(),
+    customer_id: zod_1.z.string().default(""), // ETO: maps to user_id
+    metadata: zod_1.z.string().default(""),
+}));
+// Response from tinybird endpoint (following Dub's leadEventSchemaTBEndpoint pattern)
+exports.leadEventSchemaTBEndpoint = zod_1.z.object({
+    event: zod_1.z.literal("lead"),
+    timestamp: zod_1.z.string(),
+    event_id: zod_1.z.string(),
+    event_name: zod_1.z.string(),
+    customer_id: zod_1.z.string(),
+    click_id: zod_1.z.string(),
+    link_id: zod_1.z.string(),
+    url: zod_1.z.string(),
+    continent: zod_1.z.string().nullable(),
+    country: zod_1.z.string().nullable(),
+    region: zod_1.z.string().nullable(),
+    city: zod_1.z.string().nullable(),
+    device: zod_1.z.string().nullable(),
+    browser: zod_1.z.string().nullable(),
+    os: zod_1.z.string().nullable(),
+    referer: zod_1.z.string().nullable(),
+    referer_url: zod_1.z.string().nullable(),
+    metadata: zod_1.z.string(),
+});
+// API response schema (following Dub's leadEventResponseSchema pattern exactly)
+exports.leadEventResponseSchema = zod_1.z.object({
+    event: zod_1.z.literal("lead"),
+    timestamp: zod_1.z.coerce.string(),
+    // core event fields
+    eventId: zod_1.z.string(),
+    eventName: zod_1.z.string(),
+    metadata: zod_1.z.any().nullish(),
+    // nested objects
+    click: clicks_1.clickEventSchema,
+    link: clicks_1.linkEventSchema,
+    customer: exports.CustomerSchema, // ETO: user as customer
+});
+//# sourceMappingURL=leads.js.map

package/dist/zod/schemas/leads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leads.js","sourceRoot":"","sources":["../../../src/zod/schemas/leads.ts"],"names":[],"mappings":";;;AAAA,6BAAuB;AACvB,qCAAgF;AAEhF,6EAA6E;AAChE,QAAA,cAAc,GAAG,OAAC,CAAC,MAAM,CAAC;IACrC,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IAClE,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC7E,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACvD,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IACzD,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAC/D,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;CAC9D,CAAC,CAAA;AAEF,qFAAqF;AACxE,QAAA,iBAAiB,GAAG,2BAAkB;KAChD,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,2FAA2F;KACrH,KAAK,CACJ,OAAC,CAAC,MAAM,CAAC;IACP,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IACpB,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE;IACtB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,uBAAuB;IAC5D,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CACjC,CAAC,CACH,CAAA;AAEH,sFAAsF;AACzE,QAAA,yBAAyB,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,OAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACxB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IACpB,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE;IACtB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;IACvB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IACnB,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;IACf,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAA;AAEF,gFAAgF;AACnE,QAAA,uBAAuB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC9C,KAAK,EAAE,OAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACxB,SAAS,EAAE,OAAC,CAAC,MAAM,CAAC,MAAM,EAAE;IAC5B,oBAAoB;IACpB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IACnB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,OAAC,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE;IAC3B,iBAAiB;IACjB,KAAK,EAAE,yBAAgB;IACvB,IAAI,EAAE,wBAAe;IACrB,QAAQ,EAAE,sBAAc,EAAE,wBAAwB;CACnD,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@etohq/utils",
-  "version": "1.5.1-alpha.2",
+  "version": "1.5.1-alpha.4",
   "description": "Eto utilities functions shared by Eto core and Modules",
   "main": "dist/index.js",
   "exports": {
@@ -44,6 +44,7 @@
     "typescript": "5.8.3"
   },
   "dependencies": {
+    "@casl/ability": "^6.5.0",
     "@graphql-codegen/core": "4.0.2",
     "@graphql-codegen/typescript": "4.0.9",
     "@graphql-tools/merge": "9.0.7",
@@ -57,8 +58,13 @@
     "pg-connection-string": "2.7.0",
     "pluralize": "8.0.0",
     "fs-extra": "10.0.0",
+    "@chronark/zod-bird": "0.3.10",
+    "zod": "3.22.4",
     "ulid": "2.3.0",
-    "@etohq/types": "1.5.1-alpha.2"
+    "nanoid": "5.1.6",
+    "@sindresorhus/slugify": "2.2.1",
+    "geojson": "^0.5.0",
+    "@etohq/types": "1.5.1-alpha.4"
   },
   "peerDependencies": {
     "@mikro-orm/core": "6.4.3",

package/dist/feature-flags/eto-v2.d.ts

@@ -1,3 +0,0 @@
-import { FeatureFlagTypes } from "@etohq/types";
-export declare const EtoV2Flag: FeatureFlagTypes.FlagSettings;
-//# sourceMappingURL=eto-v2.d.ts.map

package/dist/feature-flags/eto-v2.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"eto-v2.d.ts","sourceRoot":"","sources":["../../src/feature-flags/eto-v2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAE/C,eAAO,MAAM,SAAS,EAAE,gBAAgB,CAAC,YAKxC,CAAA"}

package/dist/feature-flags/eto-v2.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.EtoV2Flag = void 0;
-exports.EtoV2Flag = {
-    key: "eto_v2",
-    default_val: false,
-    env_key: "ETO_FF_ETO_V2",
-    description: "[WIP] Enable Eto V2",
-};
-//# sourceMappingURL=eto-v2.js.map

package/dist/feature-flags/eto-v2.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"eto-v2.js","sourceRoot":"","sources":["../../src/feature-flags/eto-v2.ts"],"names":[],"mappings":";;;AAEa,QAAA,SAAS,GAAkC;IACtD,GAAG,EAAE,QAAQ;IACb,WAAW,EAAE,KAAK;IAClB,OAAO,EAAE,eAAe;IACxB,WAAW,EAAE,qBAAqB;CACnC,CAAA"}

package/dist/feature-flags/order-editing.d.ts

@@ -1,3 +0,0 @@
-import { FeatureFlagTypes } from "@etohq/types";
-export declare const OrderEditingFeatureFlag: FeatureFlagTypes.FlagSettings;
-//# sourceMappingURL=order-editing.d.ts.map

package/dist/feature-flags/order-editing.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"order-editing.d.ts","sourceRoot":"","sources":["../../src/feature-flags/order-editing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAE/C,eAAO,MAAM,uBAAuB,EAAE,gBAAgB,CAAC,YAKtD,CAAA"}

package/dist/feature-flags/order-editing.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.OrderEditingFeatureFlag = void 0;
-exports.OrderEditingFeatureFlag = {
-    key: "order_editing",
-    default_val: true,
-    env_key: "ETO_FF_ORDER_EDITING",
-    description: "[WIP] Enable the order editing feature",
-};
-//# sourceMappingURL=order-editing.js.map

package/dist/feature-flags/order-editing.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"order-editing.js","sourceRoot":"","sources":["../../src/feature-flags/order-editing.ts"],"names":[],"mappings":";;;AAEa,QAAA,uBAAuB,GAAkC;IACpE,GAAG,EAAE,eAAe;IACpB,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,sBAAsB;IAC/B,WAAW,EAAE,wCAAwC;CACtD,CAAA"}

package/dist/feature-flags/product-categories.d.ts

@@ -1,3 +0,0 @@
-import { FeatureFlagTypes } from "@etohq/types";
-export declare const ProductCategoryFeatureFlag: FeatureFlagTypes.FlagSettings;
-//# sourceMappingURL=product-categories.d.ts.map

package/dist/feature-flags/product-categories.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"product-categories.d.ts","sourceRoot":"","sources":["../../src/feature-flags/product-categories.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAE/C,eAAO,MAAM,0BAA0B,EAAE,gBAAgB,CAAC,YAKzD,CAAA"}