@pikku/addon-meta-conversions 0.1.1

package/dist/.pikku/workflow/pikku-workflow-types.gen.ts

@@ -0,0 +1,158 @@
+/**
+ * This file was generated by @pikku/cli@0.12.6
+ */
+import { WorkflowCancelledException } from '@pikku/core/workflow'
+import {
+  workflow as coreWorkflow,
+  workflowStart as coreWorkflowStart,
+  workflowStatus as coreWorkflowStatus,
+  graphStart as coreGraphStart,
+} from '@pikku/core/workflow'
+import { template } from '@pikku/core/workflow'
+import {
+  pikkuWorkflowGraph as corePikkuWorkflowGraph,
+  type PikkuWorkflowGraphConfig,
+  type PikkuWorkflowGraphResult,
+} from '@pikku/core/workflow'
+import type { PikkuWorkflowWire, WorkflowStepOptions } from '@pikku/core/workflow'
+
+export { WorkflowCancelledException }
+import type { PikkuFunctionSessionless, PikkuFunctionConfig } from '../function/pikku-function-types.gen.js'
+import type { RPCMap, FlattenedRPCMap } from '../rpc/pikku-rpc-wirings-map.internal.gen.d.js'
+import type { WorkflowMap, GraphsMap } from './pikku-workflow-map.gen.d.js'
+
+export { template }
+
+export interface TypedWorkflow extends PikkuWorkflowWire {
+  do<K extends keyof RPCMap>(
+    stepName: string,
+    rpcName: K,
+    data: RPCMap[K]['input'],
+    options?: WorkflowStepOptions
+  ): Promise<RPCMap[K]['output']>
+
+  do<T>(
+    stepName: string,
+    fn: () => T | Promise<T>,
+    options?: WorkflowStepOptions
+  ): Promise<T>
+}
+
+export type PikkuFunctionWorkflow<
+  In = unknown,
+  Out = never
+> = PikkuFunctionSessionless<In, Out, 'workflow'>
+
+export const pikkuWorkflowFunc = <In, Out = unknown>(
+  func:
+    | PikkuFunctionWorkflow<In, Out>
+    | PikkuFunctionConfig<In, Out, 'workflow', PikkuFunctionWorkflow<In, Out>>
+) => {
+  return typeof func === 'function' ? { func } : func
+}
+
+export const pikkuWorkflowComplexFunc = <In, Out = unknown>(
+  func:
+    | PikkuFunctionWorkflow<In, Out>
+    | PikkuFunctionConfig<In, Out, 'workflow', PikkuFunctionWorkflow<In, Out>>
+) => {
+  return typeof func === 'function' ? { func } : func
+}
+
+type TypedRef<T> = { $ref: string; path?: string } & { __phantomType?: T }
+
+type TemplateString = {
+  $template: {
+    parts: string[]
+    expressions: Array<{ $ref: string; path?: string }>
+  }
+} & { __brand: 'TemplateString' }
+
+type InputWithRefs<T> = {
+  [K in keyof T]?: T[K] | TypedRef<T[K]> | TypedRef<unknown> | TemplateString
+}
+
+type NodeInputType<FuncMap extends Record<string, string>, K extends keyof FuncMap> =
+  FuncMap[K] extends keyof FlattenedRPCMap
+    ? InputWithRefs<FlattenedRPCMap[FuncMap[K]]['input']>
+    : Record<string, unknown>
+
+type NodeOutputKeys<FuncMap extends Record<string, string>, N extends string> =
+  N extends keyof FuncMap
+    ? FuncMap[N] extends keyof FlattenedRPCMap
+      ? keyof FlattenedRPCMap[FuncMap[N]]['output'] & string
+      : string
+    : string
+
+type RefFunction<FuncMap extends Record<string, string>> = {
+  <N extends Extract<keyof FuncMap, string>>(
+    nodeId: N,
+    path: NodeOutputKeys<FuncMap, N>
+  ): TypedRef<unknown>
+  (nodeId: 'trigger' | '$item', path?: string): TypedRef<unknown>
+}
+
+type TemplateFunction = (templateStr: string, refs: TypedRef<unknown>[]) => TemplateString
+
+type GraphNodeConfigMap<FuncMap extends Record<string, string>> = {
+  [K in Extract<keyof FuncMap, string>]?: {
+    next?: NextConfig<Extract<keyof FuncMap, string>>
+    input?:
+      | NodeInputType<FuncMap, K>
+      | (() => NodeInputType<FuncMap, K>)
+      | ((ref: RefFunction<FuncMap>, template: TemplateFunction) => NodeInputType<FuncMap, K>)
+    onError?: Extract<keyof FuncMap, string> | Extract<keyof FuncMap, string>[]
+  }
+}
+
+type NextConfig<NodeIds extends string> = NodeIds | NodeIds[] | { if: string; then: NodeIds; else?: NodeIds }
+
+export function pikkuWorkflowGraph<
+  const FuncMap extends Record<string, keyof FlattenedRPCMap & string>
+>(
+  config: PikkuWorkflowGraphConfig<FuncMap, GraphNodeConfigMap<FuncMap>>
+): PikkuWorkflowGraphResult {
+  return corePikkuWorkflowGraph(config as any)
+}
+
+export const workflow = <Name extends keyof WorkflowMap>(
+  workflowName: Name,
+  options?: { pollIntervalMs?: number }
+) => {
+  return coreWorkflow<WorkflowMap>(workflowName as string & keyof WorkflowMap, options) as PikkuFunctionConfig<
+    WorkflowMap[Name]['input'],
+    WorkflowMap[Name]['output'],
+    'session' | 'rpc'
+  >
+}
+
+export const workflowStart = <Name extends keyof WorkflowMap>(
+  workflowName: Name
+) => {
+  return coreWorkflowStart<WorkflowMap>(workflowName as string & keyof WorkflowMap) as PikkuFunctionConfig<
+    WorkflowMap[Name]['input'],
+    { runId: string },
+    'session' | 'rpc'
+  >
+}
+
+export const workflowStatus = <Name extends keyof WorkflowMap>(
+  _workflowName: Name
+) => {
+  return coreWorkflowStatus<WorkflowMap>(_workflowName as string & keyof WorkflowMap) as PikkuFunctionConfig<
+    { runId: string },
+    { id: string; status: 'running' | 'completed' | 'failed' | 'cancelled'; output?: WorkflowMap[Name]['output']; error?: { message?: string } },
+    'session' | 'rpc'
+  >
+}
+
+export const graphStart = <Name extends keyof GraphsMap, Node extends string & keyof GraphsMap[Name]>(
+  graphName: Name,
+  startNode: Node
+) => {
+  return coreGraphStart<GraphsMap>(graphName as string & keyof GraphsMap, startNode as string) as PikkuFunctionConfig<
+    GraphsMap[Name][Node] extends { input: infer I } ? I : never,
+    { runId: string },
+    'session' | 'rpc'
+  >
+}

package/dist/.pikku/workflow/pikku-workflow-wirings-meta.gen.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pikku-workflow-wirings-meta.gen.d.ts.map

package/dist/.pikku/workflow/pikku-workflow-wirings-meta.gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-workflow-wirings-meta.gen.d.ts","sourceRoot":"","sources":["../../../.pikku/workflow/pikku-workflow-wirings-meta.gen.ts"],"names":[],"mappings":""}

package/dist/.pikku/workflow/pikku-workflow-wirings-meta.gen.js

@@ -0,0 +1,7 @@
+/**
+ * This file was generated by @pikku/cli@0.12.6
+ */
+import { pikkuState } from '@pikku/core/internal';
+const workflowsMeta = {};
+pikkuState('@pikku/addon-meta-conversions', 'workflows', 'meta', workflowsMeta);
+//# sourceMappingURL=pikku-workflow-wirings-meta.gen.js.map

package/dist/.pikku/workflow/pikku-workflow-wirings-meta.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-workflow-wirings-meta.gen.js","sourceRoot":"","sources":["../../../.pikku/workflow/pikku-workflow-wirings-meta.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAGjD,MAAM,aAAa,GAA6B,EAAE,CAAA;AAElD,UAAU,CAAC,+BAA+B,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,CAAC,CAAA"}

package/dist/.pikku/workflow/pikku-workflow-wirings-meta.gen.ts

@@ -0,0 +1,9 @@
+/**
+ * This file was generated by @pikku/cli@0.12.6
+ */
+import { pikkuState } from '@pikku/core/internal'
+import type { SerializedWorkflowGraphs } from '@pikku/inspector/workflow-graph'
+
+const workflowsMeta: SerializedWorkflowGraphs = {}
+
+pikkuState('@pikku/addon-meta-conversions', 'workflows', 'meta', workflowsMeta)

package/dist/.pikku/workflow/pikku-workflow-wirings.gen.d.ts

@@ -0,0 +1,5 @@
+export {};
+/**
+ * This file was generated by @pikku/cli@0.12.6
+ */
+//# sourceMappingURL=pikku-workflow-wirings.gen.d.ts.map

package/dist/.pikku/workflow/pikku-workflow-wirings.gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-workflow-wirings.gen.d.ts","sourceRoot":"","sources":["../../../.pikku/workflow/pikku-workflow-wirings.gen.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/.pikku/workflow/pikku-workflow-wirings.gen.js

@@ -0,0 +1,5 @@
+export {};
+/**
+ * This file was generated by @pikku/cli@0.12.6
+ */
+//# sourceMappingURL=pikku-workflow-wirings.gen.js.map

package/dist/.pikku/workflow/pikku-workflow-wirings.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-workflow-wirings.gen.js","sourceRoot":"","sources":["../../../.pikku/workflow/pikku-workflow-wirings.gen.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/.pikku/workflow/pikku-workflow-wirings.gen.ts

@@ -0,0 +1,3 @@
+/**
+ * This file was generated by @pikku/cli@0.12.6
+ */

package/dist/src/functions/events/send.function.d.ts

@@ -0,0 +1,109 @@
+import { z } from 'zod';
+export declare const ActionSourceEnum: z.ZodEnum<{
+    website: "website";
+    email: "email";
+    app: "app";
+    phone_call: "phone_call";
+    chat: "chat";
+    physical_store: "physical_store";
+    system_generated: "system_generated";
+    other: "other";
+}>;
+export declare const UserDataSchema: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+export declare const CustomDataSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+export declare const MetaEventSchema: z.ZodObject<{
+    event_name: z.ZodString;
+    event_time: z.ZodNumber;
+    event_id: z.ZodOptional<z.ZodString>;
+    event_source_url: z.ZodOptional<z.ZodString>;
+    action_source: z.ZodEnum<{
+        website: "website";
+        email: "email";
+        app: "app";
+        phone_call: "phone_call";
+        chat: "chat";
+        physical_store: "physical_store";
+        system_generated: "system_generated";
+        other: "other";
+    }>;
+    user_data: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    custom_data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    opt_out: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const EventSendInput: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        event_name: z.ZodString;
+        event_time: z.ZodNumber;
+        event_id: z.ZodOptional<z.ZodString>;
+        event_source_url: z.ZodOptional<z.ZodString>;
+        action_source: z.ZodEnum<{
+            website: "website";
+            email: "email";
+            app: "app";
+            phone_call: "phone_call";
+            chat: "chat";
+            physical_store: "physical_store";
+            system_generated: "system_generated";
+            other: "other";
+        }>;
+        user_data: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+        custom_data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        opt_out: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    test_event_code: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const EventSendOutput: z.ZodObject<{
+    events_received: z.ZodNumber;
+    messages: z.ZodArray<z.ZodString>;
+    fbtrace_id: z.ZodString;
+}, z.core.$strip>;
+export declare const eventSend: import("#pikku").PikkuFunctionConfig<{
+    data: {
+        event_name: string;
+        event_time: number;
+        action_source: "website" | "email" | "app" | "phone_call" | "chat" | "physical_store" | "system_generated" | "other";
+        user_data: Record<string, string | string[]>;
+        event_id?: string | undefined;
+        event_source_url?: string | undefined;
+        custom_data?: Record<string, unknown> | undefined;
+        opt_out?: boolean | undefined;
+    }[];
+    test_event_code?: string | undefined;
+}, {
+    events_received: number;
+    messages: string[];
+    fbtrace_id: string;
+}, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
+    data: {
+        event_name: string;
+        event_time: number;
+        action_source: "website" | "email" | "app" | "phone_call" | "chat" | "physical_store" | "system_generated" | "other";
+        user_data: Record<string, string | string[]>;
+        event_id?: string | undefined;
+        event_source_url?: string | undefined;
+        custom_data?: Record<string, unknown> | undefined;
+        opt_out?: boolean | undefined;
+    }[];
+    test_event_code?: string | undefined;
+}, {
+    events_received: number;
+    messages: string[];
+    fbtrace_id: string;
+}, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+    data: {
+        event_name: string;
+        event_time: number;
+        action_source: "website" | "email" | "app" | "phone_call" | "chat" | "physical_store" | "system_generated" | "other";
+        user_data: Record<string, string | string[]>;
+        event_id?: string | undefined;
+        event_source_url?: string | undefined;
+        custom_data?: Record<string, unknown> | undefined;
+        opt_out?: boolean | undefined;
+    }[];
+    test_event_code?: string | undefined;
+}, {
+    events_received: number;
+    messages: string[];
+    fbtrace_id: string;
+}, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+//# sourceMappingURL=send.function.d.ts.map

package/dist/src/functions/events/send.function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.function.d.ts","sourceRoot":"","sources":["../../../../src/functions/events/send.function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,gBAAgB;;;;;;;;;EAG3B,CAAA;AAEF,eAAO,MAAM,cAAc,uFACoH,CAAA;AAE/I,eAAO,MAAM,gBAAgB,wCAC2E,CAAA;AAExG,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;iBAS1B,CAAA;AAEF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;iBAGzB,CAAA;AAEF,eAAO,MAAM,eAAe;;;;iBAI1B,CAAA;AAIF,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uEAYpB,CAAA"}

package/dist/src/functions/events/send.function.js

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import { pikkuSessionlessFunc } from '#pikku';
+export const ActionSourceEnum = z.enum([
+    'website', 'email', 'app', 'phone_call', 'chat',
+    'physical_store', 'system_generated', 'other',
+]);
+export const UserDataSchema = z.record(z.string(), z.union([z.string(), z.array(z.string())]))
+    .describe('Hashed user data for matching (em, ph, fn, ln, ct, st, zp, country, external_id, client_ip_address, client_user_agent, fbc, fbp)');
+export const CustomDataSchema = z.record(z.string(), z.unknown())
+    .describe('Custom event data (value, currency, content_name, content_ids, contents, num_items, etc.)');
+export const MetaEventSchema = z.object({
+    event_name: z.string().describe('Standard or custom event name (e.g., Purchase, Lead, AddToCart, PageView, ViewContent)'),
+    event_time: z.number().describe('Unix timestamp in seconds when the event occurred'),
+    event_id: z.string().optional().describe('Unique event ID for deduplication with browser pixel events'),
+    event_source_url: z.string().optional().describe('URL where the event occurred'),
+    action_source: ActionSourceEnum.describe('Where the conversion occurred'),
+    user_data: UserDataSchema,
+    custom_data: CustomDataSchema.optional(),
+    opt_out: z.boolean().optional().describe('If true, event is used for attribution but not ad delivery optimization'),
+});
+export const EventSendInput = z.object({
+    data: z.array(MetaEventSchema).min(1).describe('Array of server events to send (max 1000 per request)'),
+    test_event_code: z.string().optional().describe('Test event code from Events Manager for testing without affecting production data'),
+});
+export const EventSendOutput = z.object({
+    events_received: z.number().describe('Number of events received by Meta'),
+    messages: z.array(z.string()).describe('Diagnostic messages from the API'),
+    fbtrace_id: z.string().describe('Trace ID for debugging with Meta support'),
+});
+export const eventSend = pikkuSessionlessFunc({
+    description: 'Send server-side conversion events to Meta via the Conversions API',
+    node: {
+        displayName: 'Send Event',
+        category: 'Events',
+        type: 'action',
+    },
+    input: EventSendInput,
+    output: EventSendOutput,
+    func: async ({ metaConversions }, { data, test_event_code }) => {
+        return await metaConversions.sendEvents(data, test_event_code);
+    },
+});
+//# sourceMappingURL=send.function.js.map

package/dist/src/functions/events/send.function.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,2 @@
+export { eventSend } from './functions/events/send.function.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAA"}

package/dist/src/index.js

@@ -0,0 +1,3 @@
+// Meta Conversions functions - Events
+export { eventSend } from './functions/events/send.function.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAA"}

package/dist/src/meta-conversions-api.service.d.ts

@@ -0,0 +1,23 @@
+import type { MetaConversionsSecrets } from './meta-conversions.secret.js';
+export interface MetaEvent {
+    event_name: string;
+    event_time: number;
+    event_id?: string;
+    event_source_url?: string;
+    action_source: 'website' | 'email' | 'app' | 'phone_call' | 'chat' | 'physical_store' | 'system_generated' | 'other';
+    user_data: Record<string, string | string[] | undefined>;
+    custom_data?: Record<string, unknown>;
+    opt_out?: boolean;
+}
+export interface MetaSendEventsResponse {
+    events_received: number;
+    messages: string[];
+    fbtrace_id: string;
+}
+export declare class MetaConversionsService {
+    private pixelId;
+    private accessToken;
+    constructor(secrets: MetaConversionsSecrets);
+    sendEvents(events: MetaEvent[], testEventCode?: string): Promise<MetaSendEventsResponse>;
+}
+//# sourceMappingURL=meta-conversions-api.service.d.ts.map

package/dist/src/meta-conversions-api.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-conversions-api.service.d.ts","sourceRoot":"","sources":["../../src/meta-conversions-api.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AAK1E,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,aAAa,EAAE,SAAS,GAAG,OAAO,GAAG,KAAK,GAAG,YAAY,GAAG,MAAM,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,OAAO,CAAA;IACpH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAA;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,WAAW,CAAQ;gBAEf,OAAO,EAAE,sBAAsB;IAKrC,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;CAwB/F"}

package/dist/src/meta-conversions-api.service.js

@@ -0,0 +1,29 @@
+const BASE_URL = 'https://graph.facebook.com';
+const API_VERSION = 'v21.0';
+export class MetaConversionsService {
+    constructor(secrets) {
+        this.pixelId = secrets.pixelId;
+        this.accessToken = secrets.accessToken;
+    }
+    async sendEvents(events, testEventCode) {
+        const url = `${BASE_URL}/${API_VERSION}/${this.pixelId}/events`;
+        const body = {
+            data: events,
+            access_token: this.accessToken,
+        };
+        if (testEventCode) {
+            body.test_event_code = testEventCode;
+        }
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Meta Conversions API error (${response.status}): ${errorText}`);
+        }
+        return response.json();
+    }
+}
+//# sourceMappingURL=meta-conversions-api.service.js.map

package/dist/src/meta-conversions-api.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-conversions-api.service.js","sourceRoot":"","sources":["../../src/meta-conversions-api.service.ts"],"names":[],"mappings":"AAEA,MAAM,QAAQ,GAAG,4BAA4B,CAAA;AAC7C,MAAM,WAAW,GAAG,OAAO,CAAA;AAmB3B,MAAM,OAAO,sBAAsB;IAIjC,YAAY,OAA+B;QACzC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAA;QAC9B,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAA;IACxC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAmB,EAAE,aAAsB;QAC1D,MAAM,GAAG,GAAG,GAAG,QAAQ,IAAI,WAAW,IAAI,IAAI,CAAC,OAAO,SAAS,CAAA;QAE/D,MAAM,IAAI,GAA4B;YACpC,IAAI,EAAE,MAAM;YACZ,YAAY,EAAE,IAAI,CAAC,WAAW;SAC/B,CAAA;QACD,IAAI,aAAa,EAAE,CAAC;YAClB,IAAI,CAAC,eAAe,GAAG,aAAa,CAAA;QACtC,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAA;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;YACvC,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,CAAC,MAAM,MAAM,SAAS,EAAE,CAAC,CAAA;QAClF,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAqC,CAAA;IAC3D,CAAC;CACF"}

package/dist/src/meta-conversions.secret.d.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+export declare const metaConversionsSecretsSchema: z.ZodObject<{
+    pixelId: z.ZodString;
+    accessToken: z.ZodString;
+}, z.core.$strip>;
+export type MetaConversionsSecrets = z.infer<typeof metaConversionsSecretsSchema>;
+//# sourceMappingURL=meta-conversions.secret.d.ts.map

package/dist/src/meta-conversions.secret.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-conversions.secret.d.ts","sourceRoot":"","sources":["../../src/meta-conversions.secret.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,4BAA4B;;;iBAGvC,CAAA;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA"}

package/dist/src/meta-conversions.secret.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import { wireSecret } from '@pikku/core/secret';
+export const metaConversionsSecretsSchema = z.object({
+    pixelId: z.string().describe('Meta Pixel ID'),
+    accessToken: z.string().describe('Conversions API access token (generated in Events Manager)'),
+});
+wireSecret({
+    name: 'metaConversions',
+    displayName: 'Meta Conversions API',
+    description: 'Meta (Facebook) Conversions API for server-side event tracking',
+    secretId: 'META_CONVERSIONS_CREDENTIALS',
+    schema: metaConversionsSecretsSchema,
+});
+//# sourceMappingURL=meta-conversions.secret.js.map

package/dist/src/meta-conversions.secret.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-conversions.secret.js","sourceRoot":"","sources":["../../src/meta-conversions.secret.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAE/C,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;IAC7C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;CAC/F,CAAC,CAAA;AAIF,UAAU,CAAC;IACT,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,sBAAsB;IACnC,WAAW,EAAE,gEAAgE;IAC7E,QAAQ,EAAE,8BAA8B;IACxC,MAAM,EAAE,4BAA4B;CACrC,CAAC,CAAA"}

package/dist/src/services.d.ts

@@ -0,0 +1,2 @@
+export declare const createSingletonServices: (config: import("../types/application-types.js").Config, existingServices?: Partial<import("#pikku").SingletonServices>) => Promise<import("../.pikku/pikku-services.gen.js").RequiredSingletonServices>;
+//# sourceMappingURL=services.d.ts.map

package/dist/src/services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../src/services.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,uBAAuB,0MAQlC,CAAA"}

package/dist/src/services.js

@@ -0,0 +1,8 @@
+import { MetaConversionsService } from './meta-conversions-api.service.js';
+import { pikkuAddonServices } from '#pikku';
+export const createSingletonServices = pikkuAddonServices(async (config, { secrets }) => {
+    const creds = await secrets.getSecretJSON('META_CONVERSIONS_CREDENTIALS');
+    const metaConversions = new MetaConversionsService(creds);
+    return { metaConversions };
+});
+//# sourceMappingURL=services.js.map

package/dist/src/services.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.js","sourceRoot":"","sources":["../../src/services.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAA;AAE1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAA;AAE3C,MAAM,CAAC,MAAM,uBAAuB,GAAG,kBAAkB,CAAC,KAAK,EAC7D,MAAM,EACN,EAAE,OAAO,EAAE,EACX,EAAE;IACF,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,aAAa,CAAyB,8BAA8B,CAAC,CAAA;IACjG,MAAM,eAAe,GAAG,IAAI,sBAAsB,CAAC,KAAK,CAAC,CAAA;IAEzD,OAAO,EAAE,eAAe,EAAE,CAAA;AAC5B,CAAC,CAAC,CAAA"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@pikku/addon-meta-conversions",
+  "version": "0.1.1",
+  "type": "module",
+  "imports": {
+    "#pikku": "./.pikku/pikku-types.gen.ts"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    },
+    "./.pikku/*": "./dist/.pikku/*",
+    "./.pikku/pikku-metadata.gen.json": "./dist/.pikku/pikku-metadata.gen.json",
+    "./.pikku/rpc/pikku-rpc-wirings-map.internal.gen.js": {
+      "types": "./dist/.pikku/rpc/pikku-rpc-wirings-map.internal.gen.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "prebuild": "pikku all",
+    "build": "tsc && cp -r .pikku dist/",
+    "pikku": "pikku all"
+  },
+  "peerDependencies": {
+    "@pikku/core": "*",
+    "zod": "^4"
+  },
+  "devDependencies": {
+    "@pikku/cli": "^0.12.6",
+    "@pikku/core": "^0.12.5",
+    "typescript": "^5.7.2",
+    "zod": "^4"
+  }
+}