@lokalise/content-type-app-engine-contracts 6.5.0 → 6.7.0

package/dist/index.d.ts

@@ -32,6 +32,8 @@ export * from './schemas/language/languageApiSchemas.ts';
 export * from './schemas/language/languageSchemas.ts';
 export * from './schemas/link/linkApiSchemas.ts';
 export * from './schemas/link/linkSchemas.ts';
+export * from './schemas/preview/integrationPreviewApiSchemas.ts';
+export * from './schemas/preview/integrationPreviewSchemas.ts';
 export * from './schemas/processResult/integrationProcessResultsApiSchemas.ts';
 export * from './schemas/processResult/integrationProcessResultsSchemas.ts';
 export * from './schemas/project/projectApiSchemas.ts';

package/dist/index.js

@@ -32,6 +32,8 @@ export * from './schemas/language/languageApiSchemas.js';
 export * from './schemas/language/languageSchemas.js';
 export * from './schemas/link/linkApiSchemas.js';
 export * from './schemas/link/linkSchemas.js';
+export * from './schemas/preview/integrationPreviewApiSchemas.js';
+export * from './schemas/preview/integrationPreviewSchemas.js';
 export * from './schemas/processResult/integrationProcessResultsApiSchemas.js';
 export * from './schemas/processResult/integrationProcessResultsSchemas.js';
 export * from './schemas/project/projectApiSchemas.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAA;AAChD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,6CAA6C,CAAA;AAC3D,cAAc,0CAA0C,CAAA;AACxD,cAAc,oCAAoC,CAAA;AAClD,cAAc,iCAAiC,CAAA;AAC/C,cAAc,mCAAmC,CAAA;AACjD,cAAc,iDAAiD,CAAA;AAC/D,cAAc,8CAA8C,CAAA;AAC5D,cAAc,4CAA4C,CAAA;AAC1D,cAAc,yCAAyC,CAAA;AACvD,cAAc,4CAA4C,CAAA;AAC1D,cAAc,wCAAwC,CAAA;AACtD,cAAc,8CAA8C,CAAA;AAC5D,cAAc,2CAA2C,CAAA;AACzD,cAAc,qCAAqC,CAAA;AACnD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,sCAAsC,CAAA;AACpD,cAAc,mCAAmC,CAAA;AACjD,cAAc,gDAAgD,CAAA;AAC9D,cAAc,6CAA6C,CAAA;AAC3D,cAAc,8DAA8D,CAAA;AAC5E,cAAc,2DAA2D,CAAA;AACzE,cAAc,uDAAuD,CAAA;AACrE,cAAc,oDAAoD,CAAA;AAClE,cAAc,gDAAgD,CAAA;AAC9D,cAAc,qDAAqD,CAAA;AACnE,cAAc,kDAAkD,CAAA;AAChE,cAAc,yCAAyC,CAAA;AACvD,cAAc,0CAA0C,CAAA;AACxD,cAAc,uCAAuC,CAAA;AACrD,cAAc,kCAAkC,CAAA;AAChD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gEAAgE,CAAA;AAC9E,cAAc,6DAA6D,CAAA;AAC3E,cAAc,wCAAwC,CAAA;AACtD,cAAc,qCAAqC,CAAA;AACnD,cAAc,0CAA0C,CAAA;AACxD,cAAc,uCAAuC,CAAA;AACrD,cAAc,0CAA0C,CAAA;AACxD,cAAc,uCAAuC,CAAA;AACrD,cAAc,sCAAsC,CAAA;AACpD,cAAc,mCAAmC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAA;AAChD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,6CAA6C,CAAA;AAC3D,cAAc,0CAA0C,CAAA;AACxD,cAAc,oCAAoC,CAAA;AAClD,cAAc,iCAAiC,CAAA;AAC/C,cAAc,mCAAmC,CAAA;AACjD,cAAc,iDAAiD,CAAA;AAC/D,cAAc,8CAA8C,CAAA;AAC5D,cAAc,4CAA4C,CAAA;AAC1D,cAAc,yCAAyC,CAAA;AACvD,cAAc,4CAA4C,CAAA;AAC1D,cAAc,wCAAwC,CAAA;AACtD,cAAc,8CAA8C,CAAA;AAC5D,cAAc,2CAA2C,CAAA;AACzD,cAAc,qCAAqC,CAAA;AACnD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,sCAAsC,CAAA;AACpD,cAAc,mCAAmC,CAAA;AACjD,cAAc,gDAAgD,CAAA;AAC9D,cAAc,6CAA6C,CAAA;AAC3D,cAAc,8DAA8D,CAAA;AAC5E,cAAc,2DAA2D,CAAA;AACzE,cAAc,uDAAuD,CAAA;AACrE,cAAc,oDAAoD,CAAA;AAClE,cAAc,gDAAgD,CAAA;AAC9D,cAAc,qDAAqD,CAAA;AACnE,cAAc,kDAAkD,CAAA;AAChE,cAAc,yCAAyC,CAAA;AACvD,cAAc,0CAA0C,CAAA;AACxD,cAAc,uCAAuC,CAAA;AACrD,cAAc,kCAAkC,CAAA;AAChD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,mDAAmD,CAAA;AACjE,cAAc,gDAAgD,CAAA;AAC9D,cAAc,gEAAgE,CAAA;AAC9E,cAAc,6DAA6D,CAAA;AAC3E,cAAc,wCAAwC,CAAA;AACtD,cAAc,qCAAqC,CAAA;AACnD,cAAc,0CAA0C,CAAA;AACxD,cAAc,uCAAuC,CAAA;AACrD,cAAc,0CAA0C,CAAA;AACxD,cAAc,uCAAuC,CAAA;AACrD,cAAc,sCAAsC,CAAA;AACpD,cAAc,mCAAmC,CAAA"}

package/dist/schemas/auth/integrationAuthApiSchemas.d.ts

@@ -83,6 +83,7 @@ export declare const getIntegrationAuthStatusContract: import("@lokalise/api-con
         readonly pending: 'pending';
         readonly completed: 'completed';
         readonly failed: 'failed';
+        readonly reauthRequired: 'reauth_required';
     }>;
     error: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
@@ -100,6 +101,7 @@ export declare const getIntegrationAuthStatusContract: import("@lokalise/api-con
             readonly pending: 'pending';
             readonly completed: 'completed';
             readonly failed: 'failed';
+            readonly reauthRequired: 'reauth_required';
         }>;
         error: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;

package/dist/schemas/auth/integrationAuthSchemas.d.ts

@@ -47,6 +47,7 @@ export declare const INTEGRATION_AUTH_STATUS_ENUM: {
     readonly pending: 'pending';
     readonly completed: 'completed';
     readonly failed: 'failed';
+    readonly reauthRequired: 'reauth_required';
 };
 /**
  * Response schema for integration auth status check
@@ -56,6 +57,7 @@ export declare const GET_INTEGRATION_AUTH_STATUS_RESPONSE_SCHEMA: z.ZodObject<{
         readonly pending: 'pending';
         readonly completed: 'completed';
         readonly failed: 'failed';
+        readonly reauthRequired: 'reauth_required';
     }>;
     error: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;

package/dist/schemas/auth/integrationAuthSchemas.js

@@ -65,6 +65,7 @@ export const INTEGRATION_AUTH_STATUS_ENUM = {
     pending: 'pending',
     completed: 'completed',
     failed: 'failed',
+    reauthRequired: 'reauth_required',
 };
 /**
  * Response schema for integration auth status check
@@ -75,7 +76,7 @@ export const GET_INTEGRATION_AUTH_STATUS_RESPONSE_SCHEMA = z.object({
      */
     status: z.nativeEnum(INTEGRATION_AUTH_STATUS_ENUM),
     /**
-     * Error message if status is 'failed'
+     * Error message if status is 'failed' or 'reauth_required'
      */
     error: z.string().optional(),
 });

package/dist/schemas/auth/integrationAuthSchemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"integrationAuthSchemas.js","sourceRoot":"","sources":["../../../src/schemas/auth/integrationAuthSchemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,MAAM,CAAC,MAAM,yDAAyD,GAAG,CAAC,CAAC,MAAM,CAAC;IAChF;;;OAGG;IACH,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC;;OAEG;IACH,iBAAiB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;CACjD,CAAC,CAAA;AAMF;;GAEG;AACH,MAAM,CAAC,MAAM,0DAA0D,GAAG,CAAC,CAAC,MAAM,CAAC;IACjF;;;OAGG;IACH,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE;CACxB,CAAC,CAAA;AAMF;;GAEG;AACH,MAAM,CAAC,MAAM,oDAAoD,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3E;;;OAGG;IACH,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC;;OAEG;IACH,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;CACtC,CAAC,CAAA;AAMF;;GAEG;AACH,MAAM,CAAC,MAAM,qDAAqD,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5E;;;OAGG;IACH,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE;IACvB;;OAEG;IACH,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;CACnC,CAAC,CAAA;AAMF;;GAEG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1D,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE;CACxB,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,8CAA8C,GAAG,mCAAmC,CAAA;AAMjG;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;CACR,CAAA;AAEV;;GAEG;AACH,MAAM,CAAC,MAAM,2CAA2C,GAAG,CAAC,CAAC,MAAM,CAAC;IAClE;;OAEG;IACH,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,4BAA4B,CAAC;IAClD;;OAEG;IACH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAA;AAMF;;GAEG;AACH,MAAM,CAAC,MAAM,iDAAiD,GAAG,mCAAmC,CAAA;AAMpG;;;GAGG;AACH,MAAM,CAAC,MAAM,0CAA0C,GAAG,CAAC,CAAC,MAAM,CAAC;IACjE;;OAEG;IACH,KAAK,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC;IACxB;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAA;AAMF;;GAEG;AACH,MAAM,CAAC,MAAM,8CAA8C,GAAG,CAAC,CAAC,MAAM,CAAC;IACrE;;OAEG;IACH,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB;;OAEG;IACH,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE;CACxB,CAAC,CAAA;AAMF;;GAEG;AACH,MAAM,CAAC,MAAM,0CAA0C,GAAG,mCAAmC,CAAA;AAM7F;;;GAGG;AACH,MAAM,CAAC,MAAM,uCAAuC,GAClD,qDAAqD,CAAA"}
+{"version":3,"file":"integrationAuthSchemas.js","sourceRoot":"","sources":["../../../src/schemas/auth/integrationAuthSchemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,MAAM,CAAC,MAAM,yDAAyD,GAAG,CAAC,CAAC,MAAM,CAAC;IAChF;;;OAGG;IACH,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC;;OAEG;IACH,iBAAiB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;CACjD,CAAC,CAAA;AAMF;;GAEG;AACH,MAAM,CAAC,MAAM,0DAA0D,GAAG,CAAC,CAAC,MAAM,CAAC;IACjF;;;OAGG;IACH,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE;CACxB,CAAC,CAAA;AAMF;;GAEG;AACH,MAAM,CAAC,MAAM,oDAAoD,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3E;;;OAGG;IACH,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC;;OAEG;IACH,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;CACtC,CAAC,CAAA;AAMF;;GAEG;AACH,MAAM,CAAC,MAAM,qDAAqD,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5E;;;OAGG;IACH,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE;IACvB;;OAEG;IACH,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;CACnC,CAAC,CAAA;AAMF;;GAEG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1D,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE;CACxB,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,8CAA8C,GAAG,mCAAmC,CAAA;AAMjG;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,cAAc,EAAE,iBAAiB;CACzB,CAAA;AAEV;;GAEG;AACH,MAAM,CAAC,MAAM,2CAA2C,GAAG,CAAC,CAAC,MAAM,CAAC;IAClE;;OAEG;IACH,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,4BAA4B,CAAC;IAClD;;OAEG;IACH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAA;AAMF;;GAEG;AACH,MAAM,CAAC,MAAM,iDAAiD,GAAG,mCAAmC,CAAA;AAMpG;;;GAGG;AACH,MAAM,CAAC,MAAM,0CAA0C,GAAG,CAAC,CAAC,MAAM,CAAC;IACjE;;OAEG;IACH,KAAK,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC;IACxB;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAA;AAMF;;GAEG;AACH,MAAM,CAAC,MAAM,8CAA8C,GAAG,CAAC,CAAC,MAAM,CAAC;IACrE;;OAEG;IACH,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB;;OAEG;IACH,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE;CACxB,CAAC,CAAA;AAMF;;GAEG;AACH,MAAM,CAAC,MAAM,0CAA0C,GAAG,mCAAmC,CAAA;AAM7F;;;GAGG;AACH,MAAM,CAAC,MAAM,uCAAuC,GAClD,qDAAqD,CAAA"}

package/dist/schemas/preview/integrationPreviewApiSchemas.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Contract for resolving the connected site and its staging origin for in-context preview
+ * GET /v1/integrations/{integrationId}/preview-site
+ *
+ * Proxies the connector's `GET /v1/preview-site` with the integration's stored auth.
+ * The response is the connector contract's typed `available` / `unavailable` state;
+ * connectors without preview support answer 400 `PREVIEW_NOT_SUPPORTED`.
+ *
+ * Accepts service-to-service tokens (the preview proxy) as well as user tokens
+ * with access to the integration.
+ */
+export declare const getIntegrationPreviewSiteContract: import("@lokalise/api-contracts").GetRouteDefinition<import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+    state: import("zod").ZodLiteral<"available">;
+    site: import("zod").ZodObject<{
+        id: import("zod").ZodString;
+        name: import("zod").ZodString;
+        stagingOrigin: import("zod").ZodString;
+        lastPublishedAt: import("zod").ZodNullable<import("zod").ZodISODateTime>;
+        assetOrigins: import("zod").ZodArray<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    state: import("zod").ZodLiteral<"unavailable">;
+    reason: import("zod").ZodEnum<{
+        SITE_NOT_FOUND: "SITE_NOT_FOUND";
+        SITE_NOT_PUBLISHED: "SITE_NOT_PUBLISHED";
+        NO_STAGING_ORIGIN: "NO_STAGING_ORIGIN";
+    }>;
+}, import("zod/v4/core").$strip>], "state">, import("zod").ZodObject<{
+    integrationId: import("zod").ZodGUID;
+}, import("zod/v4/core").$strip>, undefined, import("zod").ZodObject<{
+    authorization: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, undefined, false, false, {
+    200: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+        state: import("zod").ZodLiteral<"available">;
+        site: import("zod").ZodObject<{
+            id: import("zod").ZodString;
+            name: import("zod").ZodString;
+            stagingOrigin: import("zod").ZodString;
+            lastPublishedAt: import("zod").ZodNullable<import("zod").ZodISODateTime>;
+            assetOrigins: import("zod").ZodArray<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        state: import("zod").ZodLiteral<"unavailable">;
+        reason: import("zod").ZodEnum<{
+            SITE_NOT_FOUND: "SITE_NOT_FOUND";
+            SITE_NOT_PUBLISHED: "SITE_NOT_PUBLISHED";
+            NO_STAGING_ORIGIN: "NO_STAGING_ORIGIN";
+        }>;
+    }, import("zod/v4/core").$strip>], "state">;
+    400: import("zod").ZodObject<{
+        message: import("zod").ZodString;
+        code: import("zod").ZodString;
+        errorCode: import("zod").ZodString;
+        details: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodAny>>;
+    }, import("zod/v4/core").$strip>;
+    401: import("zod").ZodObject<{
+        message: import("zod").ZodString;
+        code: import("zod").ZodString;
+        errorCode: import("zod").ZodString;
+        details: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodAny>>;
+    }, import("zod/v4/core").$strip>;
+    404: import("zod").ZodObject<{
+        message: import("zod").ZodString;
+        code: import("zod").ZodString;
+        errorCode: import("zod").ZodString;
+        details: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodAny>>;
+    }, import("zod/v4/core").$strip>;
+}>;
+/**
+ * Contract for resolving the pages that render an item, for in-context preview
+ * GET /v1/integrations/{integrationId}/preview-targets?itemId=
+ *
+ * `itemId` is the connector item identifier (`ItemIdentifier.groupId`), which
+ * autopilot stores as the content item `sourceId`. Paths are relative to the
+ * staging origin returned by the preview-site endpoint.
+ */
+export declare const getIntegrationPreviewTargetsContract: import("@lokalise/api-contracts").GetRouteDefinition<import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+    state: import("zod").ZodLiteral<"resolved">;
+    siteId: import("zod").ZodString;
+    targets: import("zod").ZodArray<import("zod").ZodObject<{
+        id: import("zod").ZodString;
+        path: import("zod").ZodString;
+        label: import("zod").ZodString;
+        kind: import("zod").ZodEnum<{
+            page: "page";
+            collection_index: "collection_index";
+            collection_detail: "collection_detail";
+        }>;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    state: import("zod").ZodLiteral<"unsupported">;
+    siteId: import("zod").ZodString;
+    reason: import("zod").ZodEnum<{
+        ITEM_NOT_FOUND: "ITEM_NOT_FOUND";
+        ITEM_NOT_PREVIEWABLE: "ITEM_NOT_PREVIEWABLE";
+        ITEM_NOT_PUBLISHED: "ITEM_NOT_PUBLISHED";
+    }>;
+}, import("zod/v4/core").$strip>], "state">, import("zod").ZodObject<{
+    integrationId: import("zod").ZodGUID;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    itemId: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    authorization: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, undefined, false, false, {
+    200: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+        state: import("zod").ZodLiteral<"resolved">;
+        siteId: import("zod").ZodString;
+        targets: import("zod").ZodArray<import("zod").ZodObject<{
+            id: import("zod").ZodString;
+            path: import("zod").ZodString;
+            label: import("zod").ZodString;
+            kind: import("zod").ZodEnum<{
+                page: "page";
+                collection_index: "collection_index";
+                collection_detail: "collection_detail";
+            }>;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        state: import("zod").ZodLiteral<"unsupported">;
+        siteId: import("zod").ZodString;
+        reason: import("zod").ZodEnum<{
+            ITEM_NOT_FOUND: "ITEM_NOT_FOUND";
+            ITEM_NOT_PREVIEWABLE: "ITEM_NOT_PREVIEWABLE";
+            ITEM_NOT_PUBLISHED: "ITEM_NOT_PUBLISHED";
+        }>;
+    }, import("zod/v4/core").$strip>], "state">;
+    400: import("zod").ZodObject<{
+        message: import("zod").ZodString;
+        code: import("zod").ZodString;
+        errorCode: import("zod").ZodString;
+        details: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodAny>>;
+    }, import("zod/v4/core").$strip>;
+    401: import("zod").ZodObject<{
+        message: import("zod").ZodString;
+        code: import("zod").ZodString;
+        errorCode: import("zod").ZodString;
+        details: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodAny>>;
+    }, import("zod/v4/core").$strip>;
+    404: import("zod").ZodObject<{
+        message: import("zod").ZodString;
+        code: import("zod").ZodString;
+        errorCode: import("zod").ZodString;
+        details: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodAny>>;
+    }, import("zod/v4/core").$strip>;
+}>;

package/dist/schemas/preview/integrationPreviewApiSchemas.js

@@ -0,0 +1,53 @@
+import { buildGetRoute } from '@lokalise/api-contracts';
+import { previewSiteResponseBody, previewTargetsRequestQueryString, previewTargetsResponseBody, } from '@lokalise/connector-api-contracts';
+import { AUTHORIZATION_HEADER_SCHEMA, COMMON_ERROR_RESPONSE_SCHEMA_V2, } from '../commonRequestSchemas.js';
+import { INTEGRATION_PREVIEW_PATH_PARAMS_SCHEMA } from './integrationPreviewSchemas.js';
+/**
+ * Contract for resolving the connected site and its staging origin for in-context preview
+ * GET /v1/integrations/{integrationId}/preview-site
+ *
+ * Proxies the connector's `GET /v1/preview-site` with the integration's stored auth.
+ * The response is the connector contract's typed `available` / `unavailable` state;
+ * connectors without preview support answer 400 `PREVIEW_NOT_SUPPORTED`.
+ *
+ * Accepts service-to-service tokens (the preview proxy) as well as user tokens
+ * with access to the integration.
+ */
+export const getIntegrationPreviewSiteContract = buildGetRoute({
+    visibility: 'internal',
+    pathResolver: (params) => `/v1/integrations/${params.integrationId}/preview-site`,
+    description: 'Resolve the connected site and its HTTPS staging origin for in-context preview',
+    requestPathParamsSchema: INTEGRATION_PREVIEW_PATH_PARAMS_SCHEMA,
+    successResponseBodySchema: previewSiteResponseBody,
+    responseSchemasByStatusCode: {
+        200: previewSiteResponseBody,
+        400: COMMON_ERROR_RESPONSE_SCHEMA_V2,
+        401: COMMON_ERROR_RESPONSE_SCHEMA_V2,
+        404: COMMON_ERROR_RESPONSE_SCHEMA_V2,
+    },
+    requestHeaderSchema: AUTHORIZATION_HEADER_SCHEMA,
+});
+/**
+ * Contract for resolving the pages that render an item, for in-context preview
+ * GET /v1/integrations/{integrationId}/preview-targets?itemId=
+ *
+ * `itemId` is the connector item identifier (`ItemIdentifier.groupId`), which
+ * autopilot stores as the content item `sourceId`. Paths are relative to the
+ * staging origin returned by the preview-site endpoint.
+ */
+export const getIntegrationPreviewTargetsContract = buildGetRoute({
+    visibility: 'internal',
+    pathResolver: (params) => `/v1/integrations/${params.integrationId}/preview-targets`,
+    description: 'Resolve the pages that render an item as paths under the staging origin',
+    requestPathParamsSchema: INTEGRATION_PREVIEW_PATH_PARAMS_SCHEMA,
+    requestQuerySchema: previewTargetsRequestQueryString,
+    successResponseBodySchema: previewTargetsResponseBody,
+    responseSchemasByStatusCode: {
+        200: previewTargetsResponseBody,
+        400: COMMON_ERROR_RESPONSE_SCHEMA_V2,
+        401: COMMON_ERROR_RESPONSE_SCHEMA_V2,
+        404: COMMON_ERROR_RESPONSE_SCHEMA_V2,
+    },
+    requestHeaderSchema: AUTHORIZATION_HEADER_SCHEMA,
+});
+//# sourceMappingURL=integrationPreviewApiSchemas.js.map

package/dist/schemas/preview/integrationPreviewApiSchemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrationPreviewApiSchemas.js","sourceRoot":"","sources":["../../../src/schemas/preview/integrationPreviewApiSchemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,EACL,uBAAuB,EACvB,gCAAgC,EAChC,0BAA0B,GAC3B,MAAM,mCAAmC,CAAA;AAC1C,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,sCAAsC,EAAE,MAAM,gCAAgC,CAAA;AAEvF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,aAAa,CAAC;IAC7D,UAAU,EAAE,UAAU;IACtB,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,oBAAoB,MAAM,CAAC,aAAa,eAAe;IACjF,WAAW,EAAE,gFAAgF;IAC7F,uBAAuB,EAAE,sCAAsC;IAC/D,yBAAyB,EAAE,uBAAuB;IAClD,2BAA2B,EAAE;QAC3B,GAAG,EAAE,uBAAuB;QAC5B,GAAG,EAAE,+BAA+B;QACpC,GAAG,EAAE,+BAA+B;QACpC,GAAG,EAAE,+BAA+B;KACrC;IACD,mBAAmB,EAAE,2BAA2B;CACjD,CAAC,CAAA;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,aAAa,CAAC;IAChE,UAAU,EAAE,UAAU;IACtB,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,oBAAoB,MAAM,CAAC,aAAa,kBAAkB;IACpF,WAAW,EAAE,yEAAyE;IACtF,uBAAuB,EAAE,sCAAsC;IAC/D,kBAAkB,EAAE,gCAAgC;IACpD,yBAAyB,EAAE,0BAA0B;IACrD,2BAA2B,EAAE;QAC3B,GAAG,EAAE,0BAA0B;QAC/B,GAAG,EAAE,+BAA+B;QACpC,GAAG,EAAE,+BAA+B;QACpC,GAAG,EAAE,+BAA+B;KACrC;IACD,mBAAmB,EAAE,2BAA2B;CACjD,CAAC,CAAA"}

package/dist/schemas/preview/integrationPreviewSchemas.d.ts

@@ -0,0 +1,13 @@
+import type { PreviewSiteResponseBody, PreviewTargetsRequestQueryString, PreviewTargetsResponseBody } from '@lokalise/connector-api-contracts';
+import { z } from 'zod/v4';
+/**
+ * Path parameters for the integration preview endpoints
+ */
+export declare const INTEGRATION_PREVIEW_PATH_PARAMS_SCHEMA: z.ZodObject<{
+    integrationId: z.ZodGUID;
+}, z.core.$strip>;
+export type IntegrationPreviewPathParams = z.infer<typeof INTEGRATION_PREVIEW_PATH_PARAMS_SCHEMA>;
+/**
+ * Re-export types from connector-api-contracts for convenience
+ */
+export type { PreviewSiteResponseBody, PreviewTargetsRequestQueryString, PreviewTargetsResponseBody, };

package/dist/schemas/preview/integrationPreviewSchemas.js

@@ -0,0 +1,8 @@
+import { z } from 'zod/v4';
+/**
+ * Path parameters for the integration preview endpoints
+ */
+export const INTEGRATION_PREVIEW_PATH_PARAMS_SCHEMA = z.object({
+    integrationId: z.guid(),
+});
+//# sourceMappingURL=integrationPreviewSchemas.js.map

package/dist/schemas/preview/integrationPreviewSchemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrationPreviewSchemas.js","sourceRoot":"","sources":["../../../src/schemas/preview/integrationPreviewSchemas.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B;;GAEG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7D,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE;CACxB,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lokalise/content-type-app-engine-contracts",
-  "version": "6.5.0",
+  "version": "6.7.0",
   "description": "Content Type App Engine service contracts",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,7 +17,7 @@
     "zod": ">=4.5.0 <5.0.0"
   },
   "dependencies": {
-    "@lokalise/connector-api-contracts": "^11.6.0",
+    "@lokalise/connector-api-contracts": "^11.8.0",
     "@lokalise/content-conversion-api-schemas": "^1.1.0"
   },
   "devDependencies": {