@alpic-ai/api 0.0.0-dev.gdb309de → 0.0.0-dev.gdb8d6ac
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.mts +48 -26
- package/dist/index.mjs +184 -23
- package/package.json +5 -5
package/dist/index.d.mts
CHANGED
|
@@ -1,20 +1,20 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
2
|
import { InferContractRouterInputs, InferContractRouterOutputs } from "@orpc/contract";
|
|
3
3
|
//#region src/api.contract.d.ts
|
|
4
|
-
type ApiContext = {
|
|
4
|
+
export type ApiContext = {
|
|
5
5
|
request: Request & {
|
|
6
6
|
teamIds: string[];
|
|
7
7
|
defaultTeamId: string | undefined;
|
|
8
8
|
awsCognitoUserSub: string | undefined;
|
|
9
9
|
};
|
|
10
10
|
};
|
|
11
|
-
declare const deploymentStatusSchema: z.ZodEnum<{
|
|
11
|
+
export declare const deploymentStatusSchema: z.ZodEnum<{
|
|
12
12
|
ongoing: "ongoing";
|
|
13
13
|
deployed: "deployed";
|
|
14
14
|
failed: "failed";
|
|
15
15
|
canceled: "canceled";
|
|
16
16
|
}>;
|
|
17
|
-
declare const createEnvironmentContractV1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
|
|
17
|
+
export declare const createEnvironmentContractV1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
|
|
18
18
|
projectId: z.ZodString;
|
|
19
19
|
name: z.ZodString;
|
|
20
20
|
sourceBranch: z.ZodString;
|
|
@@ -35,7 +35,7 @@ declare const createEnvironmentContractV1: import("@orpc/contract").ContractProc
|
|
|
35
35
|
}>, {
|
|
36
36
|
NOT_FOUND: {};
|
|
37
37
|
}>, Record<never, never>>;
|
|
38
|
-
declare const contract: {
|
|
38
|
+
export declare const contract: {
|
|
39
39
|
teams: {
|
|
40
40
|
list: {
|
|
41
41
|
v1: import("@orpc/contract").ContractProcedureBuilderWithOutput<import("@orpc/contract").Schema<unknown, unknown>, z.ZodArray<z.ZodObject<{
|
|
@@ -470,6 +470,17 @@ declare const contract: {
|
|
|
470
470
|
NOT_FOUND: {};
|
|
471
471
|
}>, Record<never, never>>;
|
|
472
472
|
};
|
|
473
|
+
delete: {
|
|
474
|
+
v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
|
|
475
|
+
environmentId: z.ZodString;
|
|
476
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
477
|
+
success: z.ZodLiteral<true>;
|
|
478
|
+
}, z.core.$strip>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, {
|
|
479
|
+
BAD_REQUEST: {};
|
|
480
|
+
}>, {
|
|
481
|
+
NOT_FOUND: {};
|
|
482
|
+
}>, Record<never, never>>;
|
|
483
|
+
};
|
|
473
484
|
deploy: {
|
|
474
485
|
v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
|
|
475
486
|
environmentId: z.ZodString;
|
|
@@ -1223,7 +1234,7 @@ declare const contract: {
|
|
|
1223
1234
|
};
|
|
1224
1235
|
};
|
|
1225
1236
|
};
|
|
1226
|
-
declare const contractForDocs: {
|
|
1237
|
+
export declare const contractForDocs: {
|
|
1227
1238
|
deployments: {
|
|
1228
1239
|
list: {
|
|
1229
1240
|
v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
|
|
@@ -1645,6 +1656,17 @@ declare const contractForDocs: {
|
|
|
1645
1656
|
NOT_FOUND: {};
|
|
1646
1657
|
}>, Record<never, never>>;
|
|
1647
1658
|
};
|
|
1659
|
+
delete: {
|
|
1660
|
+
v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
|
|
1661
|
+
environmentId: z.ZodString;
|
|
1662
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
1663
|
+
success: z.ZodLiteral<true>;
|
|
1664
|
+
}, z.core.$strip>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, {
|
|
1665
|
+
BAD_REQUEST: {};
|
|
1666
|
+
}>, {
|
|
1667
|
+
NOT_FOUND: {};
|
|
1668
|
+
}>, Record<never, never>>;
|
|
1669
|
+
};
|
|
1648
1670
|
deploy: {
|
|
1649
1671
|
v1: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
|
|
1650
1672
|
environmentId: z.ZodString;
|
|
@@ -2398,22 +2420,22 @@ declare const contractForDocs: {
|
|
|
2398
2420
|
};
|
|
2399
2421
|
};
|
|
2400
2422
|
};
|
|
2401
|
-
type RouterInput = InferContractRouterInputs<typeof contract>;
|
|
2402
|
-
type RouterOutput = InferContractRouterOutputs<typeof contract>;
|
|
2423
|
+
export type RouterInput = InferContractRouterInputs<typeof contract>;
|
|
2424
|
+
export type RouterOutput = InferContractRouterOutputs<typeof contract>;
|
|
2403
2425
|
//#endregion
|
|
2404
2426
|
//#region src/auth-scope.d.ts
|
|
2405
2427
|
/** Credential scope required by an API route. */
|
|
2406
|
-
type AuthScope = "any" | "user";
|
|
2428
|
+
export type AuthScope = "any" | "user";
|
|
2407
2429
|
/** Accepts an API key or OAuth access token (default for most routes). */
|
|
2408
|
-
declare const AUTH_SCOPE_ANY = "any";
|
|
2430
|
+
export declare const AUTH_SCOPE_ANY = "any";
|
|
2409
2431
|
/** Requires a user OAuth access token; API keys are not accepted. */
|
|
2410
|
-
declare const AUTH_SCOPE_USER = "user";
|
|
2411
|
-
type RouteAuthMeta = {
|
|
2432
|
+
export declare const AUTH_SCOPE_USER = "user";
|
|
2433
|
+
export type RouteAuthMeta = {
|
|
2412
2434
|
authScope?: AuthScope;
|
|
2413
2435
|
};
|
|
2414
2436
|
//#endregion
|
|
2415
2437
|
//#region ../domains/src/intents/schemas.d.ts
|
|
2416
|
-
declare const intentCategoryColorSchema: z.ZodEnum<{
|
|
2438
|
+
export declare const intentCategoryColorSchema: z.ZodEnum<{
|
|
2417
2439
|
red: "red";
|
|
2418
2440
|
orange: "orange";
|
|
2419
2441
|
yellow: "yellow";
|
|
@@ -2424,7 +2446,7 @@ declare const intentCategoryColorSchema: z.ZodEnum<{
|
|
|
2424
2446
|
gray: "gray";
|
|
2425
2447
|
}>;
|
|
2426
2448
|
type IntentCategoryColor = z.infer<typeof intentCategoryColorSchema>;
|
|
2427
|
-
declare const INTENT_CATEGORY_COLORS: ("red" | "orange" | "yellow" | "green" | "blue" | "purple" | "pink" | "gray")[];
|
|
2449
|
+
export declare const INTENT_CATEGORY_COLORS: ("red" | "orange" | "yellow" | "green" | "blue" | "purple" | "pink" | "gray")[];
|
|
2428
2450
|
//#endregion
|
|
2429
2451
|
//#region ../domains/src/platforms/schemas.d.ts
|
|
2430
2452
|
declare const platformSchema: z.ZodEnum<{
|
|
@@ -2432,56 +2454,56 @@ declare const platformSchema: z.ZodEnum<{
|
|
|
2432
2454
|
claudeai: "claudeai";
|
|
2433
2455
|
}>;
|
|
2434
2456
|
type Platform = z.infer<typeof platformSchema>;
|
|
2435
|
-
declare const PLATFORM_LABELS: Record<Platform, string>;
|
|
2457
|
+
export declare const PLATFORM_LABELS: Record<Platform, string>;
|
|
2436
2458
|
//#endregion
|
|
2437
2459
|
//#region ../domains/src/projects/schemas.d.ts
|
|
2438
|
-
declare const runtimeSchema: z.ZodEnum<{
|
|
2460
|
+
export declare const runtimeSchema: z.ZodEnum<{
|
|
2439
2461
|
"python3.13": "python3.13";
|
|
2440
2462
|
"python3.14": "python3.14";
|
|
2441
2463
|
node22: "node22";
|
|
2442
2464
|
node24: "node24";
|
|
2443
2465
|
}>;
|
|
2444
|
-
declare const transportSchema: z.ZodEnum<{
|
|
2466
|
+
export declare const transportSchema: z.ZodEnum<{
|
|
2445
2467
|
stdio: "stdio";
|
|
2446
2468
|
sse: "sse";
|
|
2447
2469
|
streamablehttp: "streamablehttp";
|
|
2448
2470
|
}>;
|
|
2449
2471
|
//#endregion
|
|
2450
2472
|
//#region src/schemas.d.ts
|
|
2451
|
-
type Runtime = z.infer<typeof runtimeSchema>;
|
|
2452
|
-
type Transport = z.infer<typeof transportSchema>;
|
|
2453
|
-
declare const environmentVariableSchema: z.ZodObject<{
|
|
2473
|
+
export type Runtime = z.infer<typeof runtimeSchema>;
|
|
2474
|
+
export type Transport = z.infer<typeof transportSchema>;
|
|
2475
|
+
export declare const environmentVariableSchema: z.ZodObject<{
|
|
2454
2476
|
key: z.ZodString;
|
|
2455
2477
|
value: z.ZodString;
|
|
2456
2478
|
isSecret: z.ZodDefault<z.ZodBoolean>;
|
|
2457
2479
|
}, z.core.$strip>;
|
|
2458
|
-
declare const environmentVariablesSchema: z.ZodArray<z.ZodObject<{
|
|
2480
|
+
export declare const environmentVariablesSchema: z.ZodArray<z.ZodObject<{
|
|
2459
2481
|
key: z.ZodString;
|
|
2460
2482
|
value: z.ZodString;
|
|
2461
2483
|
isSecret: z.ZodDefault<z.ZodBoolean>;
|
|
2462
2484
|
}, z.core.$strip>>;
|
|
2463
|
-
declare const updateEnvironmentVariableSchema: z.ZodObject<{
|
|
2485
|
+
export declare const updateEnvironmentVariableSchema: z.ZodObject<{
|
|
2464
2486
|
key: z.ZodString;
|
|
2465
2487
|
value: z.ZodOptional<z.ZodString>;
|
|
2466
2488
|
isSecret: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
|
|
2467
2489
|
}, z.core.$strip>;
|
|
2468
|
-
declare const buildSettingsSchema: z.ZodObject<{
|
|
2490
|
+
export declare const buildSettingsSchema: z.ZodObject<{
|
|
2469
2491
|
installCommand: z.ZodOptional<z.ZodString>;
|
|
2470
2492
|
buildCommand: z.ZodOptional<z.ZodString>;
|
|
2471
2493
|
buildOutputDir: z.ZodOptional<z.ZodString>;
|
|
2472
2494
|
startCommand: z.ZodOptional<z.ZodString>;
|
|
2473
2495
|
}, z.core.$strip>;
|
|
2474
|
-
declare const playgroundHeaderSchema: z.ZodObject<{
|
|
2496
|
+
export declare const playgroundHeaderSchema: z.ZodObject<{
|
|
2475
2497
|
name: z.ZodString;
|
|
2476
2498
|
description: z.ZodString;
|
|
2477
2499
|
isRequired: z.ZodDefault<z.ZodBoolean>;
|
|
2478
2500
|
isSecret: z.ZodDefault<z.ZodBoolean>;
|
|
2479
2501
|
}, z.core.$strip>;
|
|
2480
|
-
declare const playgroundExamplePromptSchema: z.ZodObject<{
|
|
2502
|
+
export declare const playgroundExamplePromptSchema: z.ZodObject<{
|
|
2481
2503
|
title: z.ZodString;
|
|
2482
2504
|
prompt: z.ZodString;
|
|
2483
2505
|
}, z.core.$strip>;
|
|
2484
|
-
declare const serverFieldsSchema: z.ZodObject<{
|
|
2506
|
+
export declare const serverFieldsSchema: z.ZodObject<{
|
|
2485
2507
|
$schema: z.ZodString;
|
|
2486
2508
|
name: z.ZodString;
|
|
2487
2509
|
description: z.ZodString;
|
|
@@ -2505,4 +2527,4 @@ declare const serverFieldsSchema: z.ZodObject<{
|
|
|
2505
2527
|
}, z.core.$strip>>>;
|
|
2506
2528
|
}, z.core.$strip>;
|
|
2507
2529
|
//#endregion
|
|
2508
|
-
export {
|
|
2530
|
+
export type { IntentCategoryColor, Platform };
|
package/dist/index.mjs
CHANGED
|
@@ -2,7 +2,7 @@ import { z } from "zod";
|
|
|
2
2
|
import * as z$1 from "zod/v4";
|
|
3
3
|
import { oc } from "@orpc/contract";
|
|
4
4
|
import ms from "ms";
|
|
5
|
-
//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_supports-color@7.2.0_zod@4.4
|
|
5
|
+
//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_supports-color@7.2.0_zod@4.5.4/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/auth.js
|
|
6
6
|
/**
|
|
7
7
|
* Reusable URL validation that disallows javascript: scheme
|
|
8
8
|
*/
|
|
@@ -523,6 +523,16 @@ z.object({
|
|
|
523
523
|
createdAt: z.coerce.date(),
|
|
524
524
|
updatedAt: z.coerce.date()
|
|
525
525
|
});
|
|
526
|
+
const alpicMcpRequestLogSchema = z.object({
|
|
527
|
+
type: z.literal("mcp_request"),
|
|
528
|
+
method: z.string()
|
|
529
|
+
});
|
|
530
|
+
const alpicMcpErrorLogSchema = z.object({
|
|
531
|
+
type: z.literal("mcp_error"),
|
|
532
|
+
method: z.string(),
|
|
533
|
+
error: z.string()
|
|
534
|
+
});
|
|
535
|
+
z.union([alpicMcpRequestLogSchema, alpicMcpErrorLogSchema]);
|
|
526
536
|
z.enum([
|
|
527
537
|
"INFO",
|
|
528
538
|
"WARNING",
|
|
@@ -854,6 +864,10 @@ const clampStringField = (field) => {
|
|
|
854
864
|
const withMin = field.minLength === null ? clamped : clamped.min(field.minLength);
|
|
855
865
|
return field.description ? withMin.describe(field.description) : withMin;
|
|
856
866
|
};
|
|
867
|
+
const unboundedArrayField = (field) => {
|
|
868
|
+
const unbounded = z.array(field.element);
|
|
869
|
+
return field.description ? unbounded.describe(field.description) : unbounded;
|
|
870
|
+
};
|
|
857
871
|
const toolDefinitionSchema = z.object({
|
|
858
872
|
name: z.string(),
|
|
859
873
|
title: z.string().optional().describe("Human-friendly name for the tool, used in the UI. If not provided, `name` will be used."),
|
|
@@ -866,11 +880,19 @@ const toolDefinitionSchema = z.object({
|
|
|
866
880
|
}).optional()
|
|
867
881
|
});
|
|
868
882
|
const positiveTestCaseSchema = z.object({
|
|
869
|
-
scenario: z.string().describe("Short label for what this case demonstrates."),
|
|
870
|
-
userPrompt: z.string().describe("A realistic, standalone user message a reviewer can paste and run with no prior state or multi-turn setup. Vary phrasing and tone across cases."),
|
|
883
|
+
scenario: z.string().min(1).describe("Short label for what this case demonstrates."),
|
|
884
|
+
userPrompt: z.string().min(1).describe("A realistic, standalone user message a reviewer can paste and run with no prior state or multi-turn setup. Vary phrasing and tone across cases."),
|
|
871
885
|
toolTriggered: z.string().optional().describe("The tool this prompt should invoke."),
|
|
872
886
|
expectedOutput: z.string().optional().describe("What the user should see, including post-interaction behaviour where relevant.")
|
|
873
|
-
}).
|
|
887
|
+
}).describe("Each case: Scenario, User prompt, Tool triggered, Expected output.");
|
|
888
|
+
const positiveTestCaseDraftSchema = positiveTestCaseSchema.partial();
|
|
889
|
+
const blankPositiveTestCase = () => ({
|
|
890
|
+
scenario: "",
|
|
891
|
+
userPrompt: "",
|
|
892
|
+
toolTriggered: "",
|
|
893
|
+
expectedOutput: ""
|
|
894
|
+
});
|
|
895
|
+
const toFixedLength = (entries, length, blank) => Array.from({ length }, (_, index) => entries[index] ?? blank());
|
|
874
896
|
const screenshotEntrySchema = z.object({
|
|
875
897
|
prompt: z.string(),
|
|
876
898
|
url: z.url()
|
|
@@ -1183,9 +1205,14 @@ const chatgptTranslationLocaleSchema = z.enum([
|
|
|
1183
1205
|
"zh-TW"
|
|
1184
1206
|
]);
|
|
1185
1207
|
const negativeTestCaseSchema = z.object({
|
|
1186
|
-
scenario: z.string(),
|
|
1187
|
-
userPrompt: z.string()
|
|
1188
|
-
}).
|
|
1208
|
+
scenario: z.string().min(1),
|
|
1209
|
+
userPrompt: z.string().min(1)
|
|
1210
|
+
}).describe("Each case: Scenario + User prompt (the app should NOT trigger).");
|
|
1211
|
+
const negativeTestCaseDraftSchema = negativeTestCaseSchema.partial();
|
|
1212
|
+
const blankNegativeTestCase = () => ({
|
|
1213
|
+
scenario: "",
|
|
1214
|
+
userPrompt: ""
|
|
1215
|
+
});
|
|
1189
1216
|
const chatgptToolJustificationSchema = z.object({
|
|
1190
1217
|
toolName: z.string(),
|
|
1191
1218
|
readOnlyJustification: z.string().describe("One sentence on what the tool reads and returns."),
|
|
@@ -1220,8 +1247,8 @@ const chatgptSubmissionFormDataSchema = z.object({
|
|
|
1220
1247
|
authentication: chatgptAuthenticationSchema.describe("OAuth 2.0 or No auth. OAuth configuration is auto-discovered from the MCP server's metadata."),
|
|
1221
1248
|
tools: z.array(toolDefinitionSchema).describe("List of tools exposed by the MCP server (auto-populated from the production server's manifest)."),
|
|
1222
1249
|
toolJustifications: z.array(chatgptToolJustificationSchema).describe("Per-tool justification of `readOnlyHint`, `openWorldHint`, and `destructiveHint` annotation values. One short, specific sentence per hint describing what the tool actually does."),
|
|
1223
|
-
testCases: z.array(positiveTestCaseSchema).describe("
|
|
1224
|
-
negativeTestCases: z.array(negativeTestCaseSchema).describe("3 negative test cases: prompts where the app should NOT trigger but the model might think it is relevant. These become production routing metadata that teaches ChatGPT when to stay silent, so pick tight near-misses: a product category the app does not carry, the right brand or domain but an intent the app does not serve, or a boundary with a sibling app."),
|
|
1250
|
+
testCases: z.array(positiveTestCaseSchema).length(5).describe("Exactly 5 positive test cases. Each: Scenario, User prompt, Tool triggered, Expected output. Collectively cover the full capability across different flow stages (initial search or browse, market or locale handling, post-interaction detail, an action ChatGPT performs on the user's behalf, and a conversion or secondary tool) rather than five variations of the same first step."),
|
|
1251
|
+
negativeTestCases: z.array(negativeTestCaseSchema).length(3).describe("Exactly 3 negative test cases: prompts where the app should NOT trigger but the model might think it is relevant. These become production routing metadata that teaches ChatGPT when to stay silent, so pick tight near-misses: a product category the app does not carry, the right brand or domain but an intent the app does not serve, or a boundary with a sibling app."),
|
|
1225
1252
|
screenshots: z.array(screenshotEntrySchema.extend({ prompt: z.string().max(75, { error: "Screenshot prompts are limited to 75 characters." }) })).max(3).describe("In-app screenshots paired with the user prompt that produced them (each prompt is 75 characters max). Widget apps must show the widget UI; non-widget apps show the model response. Min 1, max 3 entries, all public. Images: 706px wide, 400–860px tall, PNG."),
|
|
1226
1253
|
translations: z.array(chatgptTranslationSchema).describe("Per-locale translation of tagline + description. English (US) is the default."),
|
|
1227
1254
|
allowedCountries: chatgptAllowedCountriesSchema.describe("Availability: all supported countries, or an allow-list / block-list of specific ones (ISO alpha-2)."),
|
|
@@ -1236,23 +1263,34 @@ const chatgptSubmissionDraftSchema = chatgptSubmissionFormDataSchema.partial().e
|
|
|
1236
1263
|
demoRecordingUrl: z.string().optional(),
|
|
1237
1264
|
serverUrl: z.string().optional(),
|
|
1238
1265
|
screenshots: z.array(screenshotDraftEntrySchema).optional(),
|
|
1266
|
+
testCases: z.array(positiveTestCaseDraftSchema).optional(),
|
|
1267
|
+
negativeTestCases: z.array(negativeTestCaseDraftSchema).optional(),
|
|
1239
1268
|
translations: z.array(chatgptTranslationSchema.extend({ tagline: z.string() })).optional()
|
|
1240
1269
|
});
|
|
1241
|
-
|
|
1270
|
+
/** Source of truth for the fields `SubmissionPrefillService.prefill({ platform: "chatgpt" })` can populate. */
|
|
1271
|
+
const chatgptPrefillFormDataSchema = chatgptSubmissionFormDataSchema.pick({
|
|
1242
1272
|
appName: true,
|
|
1243
1273
|
developerName: true,
|
|
1244
1274
|
serverUrl: true,
|
|
1245
1275
|
tools: true,
|
|
1246
1276
|
authentication: true
|
|
1247
1277
|
});
|
|
1248
|
-
|
|
1278
|
+
/** Source of truth for `SubmissionPrefillService.generate({ platform: "chatgpt" })`. */
|
|
1279
|
+
const chatgptAiGeneratedFormDataSchema = chatgptSubmissionFormDataSchema.pick({
|
|
1249
1280
|
tagline: true,
|
|
1250
1281
|
description: true,
|
|
1251
1282
|
category: true,
|
|
1252
1283
|
testCases: true,
|
|
1253
1284
|
negativeTestCases: true,
|
|
1254
1285
|
toolJustifications: true
|
|
1255
|
-
}).extend({
|
|
1286
|
+
}).extend({
|
|
1287
|
+
testCases: unboundedArrayField(chatgptSubmissionFormDataSchema.shape.testCases),
|
|
1288
|
+
negativeTestCases: unboundedArrayField(chatgptSubmissionFormDataSchema.shape.negativeTestCases)
|
|
1289
|
+
}).extend({
|
|
1290
|
+
tagline: clampStringField(chatgptSubmissionFormDataSchema.shape.tagline),
|
|
1291
|
+
testCases: z.array(positiveTestCaseDraftSchema).transform((cases) => toFixedLength(cases, 5, blankPositiveTestCase)),
|
|
1292
|
+
negativeTestCases: z.array(negativeTestCaseDraftSchema).transform((cases) => toFixedLength(cases, 3, blankNegativeTestCase))
|
|
1293
|
+
});
|
|
1256
1294
|
const claudeCategorySchema = z.enum([
|
|
1257
1295
|
"Productivity",
|
|
1258
1296
|
"Communication",
|
|
@@ -1375,7 +1413,8 @@ const claudeSubmissionDraftSchema = claudeSubmissionFormDataSchema.partial().ext
|
|
|
1375
1413
|
categories: z.array(claudeCategorySchema).optional(),
|
|
1376
1414
|
screenshots: z.array(screenshotDraftEntrySchema).optional()
|
|
1377
1415
|
});
|
|
1378
|
-
|
|
1416
|
+
/** Source of truth for the fields `SubmissionPrefillService.prefill({ platform: "claudeai" })` can populate. */
|
|
1417
|
+
const claudePrefillFormDataSchema = claudeSubmissionFormDataSchema.pick({
|
|
1379
1418
|
serverUrl: true,
|
|
1380
1419
|
name: true,
|
|
1381
1420
|
slug: true,
|
|
@@ -1397,24 +1436,76 @@ const claudeAiGeneratedFormDataRawSchema = z.object({
|
|
|
1397
1436
|
categories: z.array(claudeCategorySchema).describe(claudeCategoryDescription),
|
|
1398
1437
|
primaryUseCases: claudeSubmissionFormDataSchema.shape.primaryUseCases
|
|
1399
1438
|
});
|
|
1400
|
-
claudeAiGeneratedFormDataRawSchema.extend({
|
|
1439
|
+
const claudeAiGeneratedFormDataSchema = claudeAiGeneratedFormDataRawSchema.extend({
|
|
1401
1440
|
oneLiner: clampStringField(claudeSubmissionFormDataSchema.shape.oneLiner),
|
|
1402
1441
|
categories: claudeAiGeneratedFormDataRawSchema.shape.categories.transform((categories) => categories.slice(0, 5))
|
|
1403
1442
|
});
|
|
1443
|
+
function provenanceByField(prefillShape, aiGeneratedShape) {
|
|
1444
|
+
const byField = {};
|
|
1445
|
+
for (const field of Object.keys(prefillShape)) byField[field] = "prefilled";
|
|
1446
|
+
for (const field of Object.keys(aiGeneratedShape)) byField[field] = "ai-generated";
|
|
1447
|
+
return byField;
|
|
1448
|
+
}
|
|
1449
|
+
provenanceByField(claudePrefillFormDataSchema.shape, claudeAiGeneratedFormDataSchema.shape), provenanceByField(chatgptPrefillFormDataSchema.shape, chatgptAiGeneratedFormDataSchema.shape);
|
|
1450
|
+
const urlVerificationOutcomeSchema = z.enum([
|
|
1451
|
+
"pass",
|
|
1452
|
+
"fail",
|
|
1453
|
+
"unverified"
|
|
1454
|
+
]);
|
|
1455
|
+
const VERIFIABLE_URL_FIELDS = {
|
|
1456
|
+
chatgpt: ["privacyPolicyUrl", "termsOfServiceUrl"],
|
|
1457
|
+
claudeai: ["privacyPolicy"]
|
|
1458
|
+
};
|
|
1459
|
+
const verifiableUrlFieldSchema = z.enum([...VERIFIABLE_URL_FIELDS.chatgpt, ...VERIFIABLE_URL_FIELDS.claudeai]);
|
|
1460
|
+
const policyDisclosureSchema = z.enum([
|
|
1461
|
+
"dataCategories",
|
|
1462
|
+
"purposesOfUse",
|
|
1463
|
+
"recipients",
|
|
1464
|
+
"retention"
|
|
1465
|
+
]);
|
|
1466
|
+
const urlVerificationFieldResultSchema = z.object({
|
|
1467
|
+
field: verifiableUrlFieldSchema,
|
|
1468
|
+
url: z.string(),
|
|
1469
|
+
outcome: urlVerificationOutcomeSchema,
|
|
1470
|
+
reason: z.string(),
|
|
1471
|
+
concerns: z.array(z.string()).optional(),
|
|
1472
|
+
scrapedWith: z.enum(["fetch", "firecrawl"]).optional()
|
|
1473
|
+
});
|
|
1474
|
+
const urlVerificationSchema = z.object({
|
|
1475
|
+
verifiedAt: z.coerce.date(),
|
|
1476
|
+
results: z.array(urlVerificationFieldResultSchema)
|
|
1477
|
+
});
|
|
1478
|
+
const pageKindSchema = z.enum([
|
|
1479
|
+
"expectedDocument",
|
|
1480
|
+
"errorPage",
|
|
1481
|
+
"loginWall",
|
|
1482
|
+
"parkedDomain",
|
|
1483
|
+
"comingSoon",
|
|
1484
|
+
"marketingPage",
|
|
1485
|
+
"unrelatedDocument"
|
|
1486
|
+
]);
|
|
1487
|
+
z.object({
|
|
1488
|
+
pageKind: pageKindSchema.describe("What the page actually is. Use 'expectedDocument' only when it is genuinely the document the field claims."),
|
|
1489
|
+
reason: z.string().max(200).describe("One sentence naming what the page is, addressed to the developer who entered the URL."),
|
|
1490
|
+
missingDisclosures: z.array(policyDisclosureSchema).describe("For a privacy policy only: which of the four required disclosures the text does not cover. Empty for every other page kind.")
|
|
1491
|
+
});
|
|
1404
1492
|
const submissionMetaFieldsSchema = z.object({
|
|
1405
1493
|
id: z.string(),
|
|
1406
1494
|
environmentId: z.string(),
|
|
1407
1495
|
auditId: z.string().nullable(),
|
|
1496
|
+
urlVerification: urlVerificationSchema.nullable().default(null),
|
|
1408
1497
|
createdAt: z.coerce.date(),
|
|
1409
1498
|
updatedAt: z.coerce.date()
|
|
1410
1499
|
});
|
|
1411
1500
|
const claudeSubmissionSchemaInternal = submissionMetaFieldsSchema.extend({
|
|
1412
1501
|
platform: z.literal("claudeai"),
|
|
1413
|
-
formData: claudeSubmissionDraftSchema
|
|
1502
|
+
formData: claudeSubmissionDraftSchema,
|
|
1503
|
+
prefillSnapshot: claudeSubmissionDraftSchema.nullable().default(null)
|
|
1414
1504
|
});
|
|
1415
1505
|
const chatgptSubmissionSchemaInternal = submissionMetaFieldsSchema.extend({
|
|
1416
1506
|
platform: z.literal("chatgpt"),
|
|
1417
|
-
formData: chatgptSubmissionDraftSchema
|
|
1507
|
+
formData: chatgptSubmissionDraftSchema,
|
|
1508
|
+
prefillSnapshot: chatgptSubmissionDraftSchema.nullable().default(null)
|
|
1418
1509
|
});
|
|
1419
1510
|
z.discriminatedUnion("platform", [claudeSubmissionSchemaInternal, chatgptSubmissionSchemaInternal]);
|
|
1420
1511
|
z.union([claudeSubmissionDraftSchema, chatgptSubmissionDraftSchema]);
|
|
@@ -1434,17 +1525,70 @@ const customerCreditsSchema = z.object({
|
|
|
1434
1525
|
expiresAt: z.number().nullable(),
|
|
1435
1526
|
currency: z.string()
|
|
1436
1527
|
});
|
|
1437
|
-
const customerUsageSchema = z.object({
|
|
1438
|
-
amountInCents: z.number(),
|
|
1439
|
-
currency: z.string(),
|
|
1440
|
-
periodEnd: z.number()
|
|
1441
|
-
});
|
|
1442
1528
|
const partnerDiscountSchema = z.object({ endsAt: z.number() });
|
|
1443
1529
|
z.object({
|
|
1444
1530
|
customerCredits: customerCreditsSchema.nullable(),
|
|
1445
|
-
customerUsage: customerUsageSchema.nullable(),
|
|
1446
1531
|
partnerDiscount: partnerDiscountSchema.nullable()
|
|
1447
1532
|
});
|
|
1533
|
+
const metricsQueueEventSchema = z.object({
|
|
1534
|
+
ts: z.number().int(),
|
|
1535
|
+
method: z.string(),
|
|
1536
|
+
tool: z.string().nullable(),
|
|
1537
|
+
client: z.string(),
|
|
1538
|
+
sessionId: z.string().nullable(),
|
|
1539
|
+
durationMs: z.number().int(),
|
|
1540
|
+
outputTokens: z.number().int().nullable(),
|
|
1541
|
+
errorType: z.enum([
|
|
1542
|
+
"mcp_error",
|
|
1543
|
+
"tool_error",
|
|
1544
|
+
"timeout"
|
|
1545
|
+
]).nullable(),
|
|
1546
|
+
errorCode: z.number().int().nullable()
|
|
1547
|
+
});
|
|
1548
|
+
z.object({
|
|
1549
|
+
v: z.literal(1),
|
|
1550
|
+
envId: z.string(),
|
|
1551
|
+
events: z.array(metricsQueueEventSchema)
|
|
1552
|
+
});
|
|
1553
|
+
z.object({ v: z.number() });
|
|
1554
|
+
const telemetrySignalSchema = z.enum([
|
|
1555
|
+
"logs",
|
|
1556
|
+
"metrics",
|
|
1557
|
+
"traces"
|
|
1558
|
+
]);
|
|
1559
|
+
const otlpProtocolSchema = z.enum(["http/protobuf", "http/json"]);
|
|
1560
|
+
const otlpEndpointSchema = z.string().trim().min(1).max(2048);
|
|
1561
|
+
const OTLP_HEADER_VALUE_MAX_LENGTH = 2048;
|
|
1562
|
+
const otlpHeaderNameSchema = z.string().trim().min(1, "Enter a header name").max(128).regex(/^[A-Za-z0-9!#$%&'*+\-.^_`|~]+$/, "Use letters, digits and !#$%&'*+-.^_`|~ only");
|
|
1563
|
+
const otlpHeaderValueSchema = z.string().trim().max(OTLP_HEADER_VALUE_MAX_LENGTH).refine((value) => !/[\r\n]/.test(value), "Line breaks are not allowed in a header value");
|
|
1564
|
+
const telemetryDestinationHeaderSchema = z.object({
|
|
1565
|
+
id: z.string(),
|
|
1566
|
+
name: otlpHeaderNameSchema,
|
|
1567
|
+
value: otlpHeaderValueSchema,
|
|
1568
|
+
isSecret: z.boolean()
|
|
1569
|
+
});
|
|
1570
|
+
const otlpPushFailureReasonSchema = z.enum([
|
|
1571
|
+
"credentials",
|
|
1572
|
+
"wrong-path",
|
|
1573
|
+
"wrong-protocol",
|
|
1574
|
+
"invalid-payload",
|
|
1575
|
+
"partial-rejection",
|
|
1576
|
+
"blocked-target",
|
|
1577
|
+
"timeout",
|
|
1578
|
+
"unreachable",
|
|
1579
|
+
"receiver-error",
|
|
1580
|
+
"unexpected-status"
|
|
1581
|
+
]);
|
|
1582
|
+
const telemetryDestinationStatusSchema = z.enum(["active", "suspended"]);
|
|
1583
|
+
z.object({
|
|
1584
|
+
id: z.string(),
|
|
1585
|
+
signal: telemetrySignalSchema,
|
|
1586
|
+
endpoint: otlpEndpointSchema,
|
|
1587
|
+
protocol: otlpProtocolSchema,
|
|
1588
|
+
headers: z.array(telemetryDestinationHeaderSchema),
|
|
1589
|
+
status: telemetryDestinationStatusSchema,
|
|
1590
|
+
lastFailureReason: otlpPushFailureReasonSchema.nullable()
|
|
1591
|
+
});
|
|
1448
1592
|
//#endregion
|
|
1449
1593
|
//#region src/auth-scope.ts
|
|
1450
1594
|
/** Accepts an API key or OAuth access token (default for most routes). */
|
|
@@ -1543,6 +1687,14 @@ const serverFieldsSchema = z.object({
|
|
|
1543
1687
|
});
|
|
1544
1688
|
//#endregion
|
|
1545
1689
|
//#region src/api.contract.ts
|
|
1690
|
+
const isValidIanaTimeZone = (timeZone) => {
|
|
1691
|
+
try {
|
|
1692
|
+
new Intl.DateTimeFormat("en-US", { timeZone });
|
|
1693
|
+
return true;
|
|
1694
|
+
} catch {
|
|
1695
|
+
return false;
|
|
1696
|
+
}
|
|
1697
|
+
};
|
|
1546
1698
|
const deploymentStatusSchema = z.enum([
|
|
1547
1699
|
"ongoing",
|
|
1548
1700
|
"deployed",
|
|
@@ -1613,6 +1765,14 @@ const getEnvironmentContractV1 = base.route({
|
|
|
1613
1765
|
createdAt: z.coerce.date(),
|
|
1614
1766
|
projectId: z.string()
|
|
1615
1767
|
}));
|
|
1768
|
+
const deleteEnvironmentContractV1 = base.route({
|
|
1769
|
+
path: "/v1/environments/{environmentId}",
|
|
1770
|
+
method: "DELETE",
|
|
1771
|
+
summary: "Delete an environment",
|
|
1772
|
+
description: "All environments can be deleted except the production environment. This operation is not reversible: associated logs, analytics, and metrics are deleted as well.",
|
|
1773
|
+
tags: ["environments"],
|
|
1774
|
+
successDescription: "The environment has been deleted successfully"
|
|
1775
|
+
}).errors({ NOT_FOUND: {} }).input(z.object({ environmentId: z.string().describe("The ID of the environment") })).output(z.object({ success: z.literal(true) }));
|
|
1616
1776
|
const domainSchema = z.object({
|
|
1617
1777
|
domain: z.string(),
|
|
1618
1778
|
status: z.enum([
|
|
@@ -1925,7 +2085,7 @@ const getProjectAnalyticsContractV1 = base.route({
|
|
|
1925
2085
|
startTimestamp: z.coerce.number().describe("Start timestamp in milliseconds"),
|
|
1926
2086
|
endTimestamp: z.coerce.number().describe("End timestamp in milliseconds"),
|
|
1927
2087
|
timeZone: z.string().describe("IANA timezone (e.g. Europe/Paris)")
|
|
1928
|
-
}).refine(({ startTimestamp, endTimestamp }) => endTimestamp - startTimestamp > 0, { message: "End date must be after start date" }).refine(({ startTimestamp, endTimestamp }) => endTimestamp - startTimestamp <=
|
|
2088
|
+
}).refine(({ startTimestamp, endTimestamp }) => endTimestamp - startTimestamp > 0, { message: "End date must be after start date" }).refine(({ startTimestamp, endTimestamp }) => endTimestamp - startTimestamp <= 26784e5, { message: "Date range must be less than 1 month" }).refine(({ timeZone }) => isValidIanaTimeZone(timeZone), { message: "Time zone must be a valid IANA timezone" })).output(z.object({
|
|
1929
2089
|
metadata: z.object({
|
|
1930
2090
|
startTimestamp: z.number(),
|
|
1931
2091
|
endTimestamp: z.number(),
|
|
@@ -2220,6 +2380,7 @@ const contract = {
|
|
|
2220
2380
|
environments: {
|
|
2221
2381
|
create: { v1: createEnvironmentContractV1 },
|
|
2222
2382
|
get: { v1: getEnvironmentContractV1 },
|
|
2383
|
+
delete: { v1: deleteEnvironmentContractV1 },
|
|
2223
2384
|
deploy: { v1: deployEnvironmentContractV1 },
|
|
2224
2385
|
getLogs: { v1: getLogsContractV1 },
|
|
2225
2386
|
getLatestLogs: { v1: getLatestLogsContractV1 }
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@alpic-ai/api",
|
|
3
|
-
"version": "0.0.0-dev.
|
|
3
|
+
"version": "0.0.0-dev.gdb8d6ac",
|
|
4
4
|
"description": "Contract for the Alpic API",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.mjs",
|
|
@@ -35,18 +35,18 @@
|
|
|
35
35
|
"dependencies": {
|
|
36
36
|
"@orpc/contract": "^1.15.0",
|
|
37
37
|
"ms": "^2.1.3",
|
|
38
|
-
"zod": "^4.4
|
|
38
|
+
"zod": "^4.5.4"
|
|
39
39
|
},
|
|
40
40
|
"devDependencies": {
|
|
41
|
+
"@alpic-ai/domains": "0.0.0",
|
|
41
42
|
"@orpc/openapi": "^1.15.0",
|
|
42
43
|
"@orpc/zod": "^1.15.0",
|
|
43
44
|
"@total-typescript/tsconfig": "^1.0.4",
|
|
44
45
|
"@types/ms": "^2.1.0",
|
|
45
46
|
"shx": "^0.4.0",
|
|
46
|
-
"tsdown": "^0.
|
|
47
|
+
"tsdown": "^0.23.0",
|
|
47
48
|
"typescript": "^6.0.3",
|
|
48
|
-
"vitest": "^4.1.
|
|
49
|
-
"@alpic-ai/domains": "0.0.0"
|
|
49
|
+
"vitest": "^4.1.11"
|
|
50
50
|
},
|
|
51
51
|
"scripts": {
|
|
52
52
|
"build": "shx rm -rf dist && tsdown",
|