@manta-eu/ldo 0.1.0

package/dist/ad-platform-links.d.ts

@@ -0,0 +1,26 @@
+export type MetaLinkKind = "campaign" | "ad_set" | "ad" | "ad_account";
+export type GoogleLinkKind = "campaign";
+export type MetaAdsManagerEntityLinkOptions = {
+    entityType: MetaLinkKind;
+    externalId: string;
+    params?: Record<string, string>;
+};
+export declare function generateMetaAdsManagerEntityLink(args: MetaAdsManagerEntityLinkOptions): string;
+export type GoogleAdsEntityLinkOptions = {
+    entityType: GoogleLinkKind;
+    externalId: string;
+};
+export declare function generateGoogleAdsEntityLink(args: GoogleAdsEntityLinkOptions): string;
+export type ExternalLink = {
+    url: string;
+    label: string;
+};
+export type LinkSpec = {
+    label: string;
+    url: (externalId: string, params?: Record<string, string>) => string | undefined;
+};
+/** IRI-keyed ad-platform link specs, for composition into the unified external-link registry. */
+export declare const adPlatformLinks: ReadonlyMap<string, LinkSpec>;
+/** Meta types that need `meta:account` → `accountId` for Ads Manager deep links. */
+export declare const metaEntityTypesNeedingAccountParam: Set<string>;
+//# sourceMappingURL=ad-platform-links.d.ts.map

package/dist/ad-platform-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ad-platform-links.d.ts","sourceRoot":"","sources":["../ad-platform-links.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,IAAI,GAAG,YAAY,CAAC;AACvE,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC;AAExC,MAAM,MAAM,+BAA+B,GAAG;IAC5C,UAAU,EAAE,YAAY,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,CAAC;AAEF,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,+BAA+B,GAAG,MAAM,CAiB9F;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,UAAU,EAAE,cAAc,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,0BAA0B,GAAG,MAAM,CAQpF;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAUF,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;CAClF,CAAC;AA0DF,iGAAiG;AACjG,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAmB,CAAC;AAE9E,oFAAoF;AACpF,eAAO,MAAM,kCAAkC,aAA8C,CAAC"}

package/dist/ad-platform-links.js

@@ -0,0 +1,85 @@
+import { google, meta } from "./.ldkit/namespaces.js";
+import { ProviderAccountEntityType } from "./manual-schemas.js";
+export function generateMetaAdsManagerEntityLink(args) {
+    const { entityType, externalId, params } = args;
+    const id = encodeURIComponent(externalId);
+    const accountId = params?.accountId;
+    const accountScope = accountId ? `&act=${encodeURIComponent(accountId)}` : "";
+    const baseUrl = "https://adsmanager.facebook.com/adsmanager/manage";
+    switch (entityType) {
+        case "campaign":
+            return `${baseUrl}/campaigns?filter_set=SEARCH_BY_CAMPAIGN_GROUP_IDS-STRING_SET%1EANY%1E%5B%22${id}%22%5D${accountScope}`;
+        case "ad_set":
+            return `${baseUrl}/adsets?filter_set=SEARCH_BY_ADGROUP_IDS-STRING_SET%1EANY%1E%5B%22${id}%22%5D${accountScope}`;
+        case "ad":
+            return `${baseUrl}/ads?filter_set=SEARCH_BY_AD_IDS-STRING_SET%1EANY%1E%5B%22${id}%22%5D${accountScope}`;
+        case "ad_account":
+            return `https://business.facebook.com/latest/home?asset_id=${id}`;
+    }
+}
+export function generateGoogleAdsEntityLink(args) {
+    const { entityType, externalId } = args;
+    const id = encodeURIComponent(externalId);
+    switch (entityType) {
+        case "campaign":
+            return `https://ads.google.com/aw/campaigns?campaignId=${id}`;
+    }
+}
+const PLATFORM_LABELS = {
+    meta: "Open in Meta Ads Manager",
+    google: "Open in Google Ads",
+    linkedin: "Open in LinkedIn Campaign Manager",
+    shopify: "Open in Shopify admin",
+    slack: "Open in Slack",
+};
+function metaLink(kind) {
+    return {
+        label: PLATFORM_LABELS.meta,
+        url: (externalId, params) => generateMetaAdsManagerEntityLink({ entityType: kind, externalId, params }),
+    };
+}
+function googleLink(kind) {
+    return {
+        label: PLATFORM_LABELS.google,
+        url: (externalId) => generateGoogleAdsEntityLink({ entityType: kind, externalId }),
+    };
+}
+function shopHandle(shopDomain) {
+    return shopDomain.replace(/\.myshopify\.com$/, "");
+}
+// IRI-keyed registry; callers pass namespace terms (`meta.Campaign`, `google.Customer`, …), not slug maps.
+const metaLinkKinds = {
+    [meta.Campaign]: "campaign",
+    [meta.AdSet]: "ad_set",
+    [meta.Ad]: "ad",
+    [meta.AdCreative]: "ad",
+    [meta.AdAccount]: "ad_account",
+    [meta.Business]: "ad_account",
+};
+const entityLinks = {
+    ...Object.fromEntries(Object.entries(metaLinkKinds).map(([uri, kind]) => [uri, metaLink(kind)])),
+    [google.Campaign]: googleLink("campaign"),
+    [ProviderAccountEntityType.GOOGLE_CUSTOMER]: {
+        label: PLATFORM_LABELS.google,
+        url: (customerId) => `https://ads.google.com/aw/overview?__c=${encodeURIComponent(customerId)}`,
+    },
+    [ProviderAccountEntityType.LINKEDIN_AD_ACCOUNT]: {
+        label: PLATFORM_LABELS.linkedin,
+        url: (accountId) => `https://www.linkedin.com/campaignmanager/accounts/${encodeURIComponent(accountId)}`,
+    },
+    [ProviderAccountEntityType.SHOPIFY_SHOP]: {
+        label: PLATFORM_LABELS.shopify,
+        url: (shopDomain) => `https://admin.shopify.com/store/${encodeURIComponent(shopHandle(shopDomain))}`,
+    },
+    // schema:identifier is a team id (T…) from the OAuth callback, or an enterprise org id (E…) from
+    // the KG mapper. Slack routes both: /client/E… resolves the org to its team and redirects there.
+    [ProviderAccountEntityType.SLACK_WORKSPACE]: {
+        label: PLATFORM_LABELS.slack,
+        url: (workspaceId) => `https://app.slack.com/client/${encodeURIComponent(workspaceId)}`,
+    },
+};
+const entityLinkByUri = new Map(Object.entries(entityLinks));
+/** IRI-keyed ad-platform link specs, for composition into the unified external-link registry. */
+export const adPlatformLinks = entityLinkByUri;
+/** Meta types that need `meta:account` → `accountId` for Ads Manager deep links. */
+export const metaEntityTypesNeedingAccountParam = new Set(Object.keys(metaLinkKinds));

package/dist/external-links.d.ts

@@ -0,0 +1,12 @@
+import { type ExternalLink } from "./ad-platform-links.js";
+export type { ExternalLink };
+export type ExternalLinkOptions = {
+    entityTypeUri: string;
+    externalId: string;
+    params?: Record<string, string>;
+};
+/** Every RDF type the registry can link, so callers can pick a node's linkable type without hard-coding integrations. */
+export declare const externalLinkTypes: ReadonlySet<string>;
+export declare function resolveExternalLink({ entityTypeUri, externalId, params, }: ExternalLinkOptions): ExternalLink | undefined;
+export declare function resolveExternalLinkLabel(entityTypeUri: string): string | undefined;
+//# sourceMappingURL=external-links.d.ts.map

package/dist/external-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-links.d.ts","sourceRoot":"","sources":["../external-links.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,YAAY,EAAiB,MAAM,qBAAqB,CAAC;AAGxF,YAAY,EAAE,YAAY,EAAE,CAAC;AAE7B,MAAM,MAAM,mBAAmB,GAAG;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,CAAC;AAMF,yHAAyH;AACzH,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAiC,CAAC;AAEpF,wBAAgB,mBAAmB,CAAC,EAClC,aAAa,EACb,UAAU,EACV,MAAM,GACP,EAAE,mBAAmB,GAAG,YAAY,GAAG,SAAS,CAIhD;AAED,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAElF"}

package/dist/external-links.js

@@ -0,0 +1,15 @@
+import { adPlatformLinks } from "./ad-platform-links.js";
+import { figmaLinks } from "./figma-links.js";
+// One IRI-keyed registry over every integration. Dispatch is a plain lookup by type — no integration
+// takes priority and there is no per-integration fallback. New integrations add their specs here.
+const externalLinks = new Map([...adPlatformLinks, ...figmaLinks]);
+/** Every RDF type the registry can link, so callers can pick a node's linkable type without hard-coding integrations. */
+export const externalLinkTypes = new Set(externalLinks.keys());
+export function resolveExternalLink({ entityTypeUri, externalId, params, }) {
+    const spec = externalLinks.get(entityTypeUri);
+    const url = spec?.url(externalId, params);
+    return spec && url ? { url, label: spec.label } : undefined;
+}
+export function resolveExternalLinkLabel(entityTypeUri) {
+    return externalLinks.get(entityTypeUri)?.label;
+}

package/dist/figma-links.d.ts

@@ -0,0 +1,6 @@
+export type FigmaLinkSpec = {
+    label: string;
+    url: (externalId: string, params?: Record<string, string>) => string | undefined;
+};
+export declare const figmaLinks: ReadonlyMap<string, FigmaLinkSpec>;
+//# sourceMappingURL=figma-links.d.ts.map

package/dist/figma-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma-links.d.ts","sourceRoot":"","sources":["../figma-links.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;CAClF,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAsBxD,CAAC"}

package/dist/figma-links.js

@@ -0,0 +1,24 @@
+import { figma } from "./.ldkit/namespaces.js";
+const figmaLinkLabel = "Open in Figma";
+export const figmaLinks = new Map([
+    [
+        figma.File,
+        {
+            label: figmaLinkLabel,
+            url: (externalId, params) => params?.url ?? `https://www.figma.com/design/${encodeURIComponent(externalId)}`,
+        },
+    ],
+    [
+        figma.Node,
+        {
+            label: figmaLinkLabel,
+            url: (externalId, params) => {
+                const fileKey = params?.fileKey;
+                if (!fileKey)
+                    return undefined;
+                const nodeId = externalId.replace(/:/g, "-");
+                return `https://www.figma.com/design/${encodeURIComponent(fileKey)}?node-id=${encodeURIComponent(nodeId)}`;
+            },
+        },
+    ],
+]);

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./.ldkit/index.js";
+export * from "./ad-platform-links.js";
+export * from "./manual-schemas.js";
+export * from "./redirect-queries.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from "./.ldkit/index.js";
+export * from "./ad-platform-links.js";
+export * from "./manual-schemas.js";
+export * from "./redirect-queries.js";