@cinerino/sdk 12.5.0-alpha.9 → 12.5.0

package/example/src/chevre/admin/adminCreateNotesIfNotExistByIdentifier.ts

@@ -5,7 +5,7 @@ import * as auth from '../../auth/authAsAdmin';
 
 const PROJECT_ID = String(process.env.PROJECT_ID);
 const SELLER_ID = '59d20831e53ebc2b4e774466';
-const EVENT_SERVICE_IDENTIFIER = 'xxx';
+const EVENT_SERVICE_ID = 'xxx';
 // const EVENT_SERVICE_ID = '656038908b1cd5ce629f5991';
 
 // tslint:disable-next-line:max-func-body-length
@@ -26,7 +26,7 @@ async function main() {
     await noteService.createNotesByIdentifier(
         [
             {
-                about: { identifier: EVENT_SERVICE_IDENTIFIER },
+                about: { id: EVENT_SERVICE_ID },
                 identifier: 'abcdefgh',
                 text: 'sample note text...'
             }
@@ -40,7 +40,7 @@ async function main() {
     await noteService.updateNotesByIdentifier(
         [
             {
-                about: { identifier: EVENT_SERVICE_IDENTIFIER },
+                about: { id: EVENT_SERVICE_ID },
                 identifier: 'abcdefgh',
                 text: 'updated text xxxxx'
             }

package/example/src/chevre/admin/findPaymentServices.ts

@@ -0,0 +1,45 @@
+// tslint:disable:no-implicit-dependencies no-console no-magic-numbers
+import * as client from '../../../../lib/';
+import * as auth from '../../auth/authAsAdmin';
+
+const PROJECT_ID = String(process.env.PROJECT_ID);
+const SELLER_ID = '59d20831e53ebc2b4e774466';
+
+async function main() {
+    const authClient = await auth.login();
+    await authClient.refreshAccessToken();
+    const loginTicket = authClient.verifyIdToken({});
+    console.log('username is', loginTicket.getUsername());
+
+    const paymentProductService = await (await client.loadChevreAdmin({
+        endpoint: <string>process.env.CHEVRE_ENDPOINT,
+        auth: authClient
+    })).createPaymentProductInstance({
+        project: { id: PROJECT_ID },
+        seller: { id: SELLER_ID }
+    });
+
+    const data = await paymentProductService.findPaymentServices({
+        limit: 10,
+        page: 1
+        // typeOf: client.factory.service.paymentService.PaymentServiceType.MovieTicket
+        // typeOfs: [
+        //     client.factory.service.paymentService.PaymentServiceType.CreditCard,
+        //     client.factory.service.paymentService.PaymentServiceType.MovieTicket
+        // ],
+        // sortByProductID: client.factory.sortType.Descending
+        // id: '5f9a52ca4f3709000abe6490'
+        // ids: ['5f9a52ca4f3709000abe6490', '5f9a52994f3709000abe6417'],
+        // nameRegex: 'Surf',
+        // productID: 'xxx',
+        // productIDRegex: 'Surf',
+    });
+    console.log(data);
+    console.log(data.length);
+}
+
+main()
+    .then(() => {
+        console.log('main processed.');
+    })
+    .catch(console.error);

package/example/src/chevre/admin/findProductHasOfferCatalog.ts

@@ -0,0 +1,35 @@
+// tslint:disable:no-implicit-dependencies no-console no-magic-numbers
+import * as client from '../../../../lib/';
+import * as auth from '../../auth/authAsAdmin';
+
+const PROJECT_ID = String(process.env.PROJECT_ID);
+
+async function main() {
+    const authClient = await auth.login();
+    await authClient.refreshAccessToken();
+    const loginTicket = authClient.verifyIdToken({});
+    console.log('username is', loginTicket.getUsername());
+
+    const productService = await (await client.loadChevreAdmin({
+        endpoint: <string>process.env.CHEVRE_ENDPOINT,
+        auth: authClient
+    })).createProductInstance({
+        project: { id: PROJECT_ID },
+        seller: { id: '' }
+    });
+
+    const data = await productService.findProductHasOfferCatalog({
+        limit: 10,
+        page: 1,
+        itemOfferedIds: ['656038908b1cd5ce629f5992']
+    });
+    // tslint:disable-next-line:no-null-keyword
+    console.dir(data, { depth: null });
+    console.log(data.length);
+}
+
+main()
+    .then(() => {
+        console.log('main processed.');
+    })
+    .catch(console.error);

package/example/src/chevre/admin/findProducts.ts

@@ -0,0 +1,48 @@
+// tslint:disable:no-implicit-dependencies no-console no-magic-numbers
+import * as client from '../../../../lib/';
+import * as auth from '../../auth/authAsAdmin';
+
+const PROJECT_ID = String(process.env.PROJECT_ID);
+const SELLER_ID = '59d20831e53ebc2b4e774466';
+
+async function main() {
+    const authClient = await auth.login();
+    await authClient.refreshAccessToken();
+    const loginTicket = authClient.verifyIdToken({});
+    console.log('username is', loginTicket.getUsername());
+
+    const productService = await (await client.loadChevreAdmin({
+        endpoint: <string>process.env.CHEVRE_ENDPOINT,
+        auth: authClient
+    })).createProductInstance({
+        project: { id: PROJECT_ID },
+        seller: { id: SELLER_ID }
+    });
+
+    const data = await productService.findProducts({
+        limit: 10,
+        page: 1,
+        typeOf: client.factory.product.ProductType.EventService,
+        // typeOfs: [client.factory.product.ProductType.EventService, client.factory.product.ProductType.Product],
+        sortByProductID: client.factory.sortType.Ascending
+        // id: '67fdca202e75a6d9af33d5c4'
+        // ids: ['67fdca202e75a6d9af33d5c4'],
+        // typeOf?: factory.product.ProductType;
+        // typeOfs?: factory.product.ProductType[];
+        // hasOfferCatalogId: '7iri37omad6t6ji',
+        // nameRegex: 'Free',
+        // productID: 'sampleFreeEventServiceBySub',
+        // productIDRegex: 'Free',
+        // serviceTypeCodeValue: '0001',
+        // serviceOutputAmountCurrency: 'Point',
+        // additionalPropertyName: 'te'
+    });
+    console.log(data);
+    console.log(data.length);
+}
+
+main()
+    .then(() => {
+        console.log('main processed.');
+    })
+    .catch(console.error);

package/example/src/chevre/default/findCategoryCodes.ts

@@ -0,0 +1,42 @@
+// tslint:disable:no-implicit-dependencies no-console
+// import * as moment from 'moment';
+
+import * as client from '../../../../lib/index';
+
+const PROJECT_ID = String(process.env.PROJECT_ID);
+
+async function main() {
+    const authClient = await client.auth.ClientCredentials.createInstance({
+        domain: <string>process.env.CHEVRE_AUTHORIZE_SERVER_DOMAIN,
+        clientId: <string>process.env.CHEVRE_CLIENT_ID,
+        clientSecret: <string>process.env.CHEVRE_CLIENT_SECRET,
+        scopes: [],
+        state: ''
+    });
+
+    const categoryCodeService = await (await client.loadChevre({
+        endpoint: <string>process.env.CHEVRE_ENDPOINT,
+        auth: authClient
+    })).createCategoryCodeInstance({
+        project: { id: PROJECT_ID },
+        seller: { id: '' }
+    });
+
+    const result = await categoryCodeService.search({
+        page: 1,
+        limit: 10,
+        inCodeSet: {
+            identifier: {
+                $eq: client.factory.categoryCode.CategorySetIdentifier.SeatingType
+            }
+        }
+    });
+    // tslint:disable-next-line:no-null-keyword
+    console.dir(result, { depth: null });
+}
+
+main()
+    .then(() => {
+        console.log('success!');
+    })
+    .catch(console.error);

package/example/src/cloud/admin/adminEventsByIdentifier.ts

@@ -0,0 +1,145 @@
+// tslint:disable:no-console
+// tslint:disable-next-line:no-implicit-dependencies
+import * as moment from 'moment-timezone';
+import { format } from 'util';
+import * as client from '../../../../lib/index';
+import * as auth from '../../auth/authAsAdmin';
+
+const PROJECT_ID = String(process.env.PROJECT_ID);
+const SELLER_ID = '59d20831e53ebc2b4e774466';
+const EVENT_SERVICE_ID = '681aa7c1b53b6dbbe5efbec7';
+const AVAILABLE_AT_OR_FROM_ID = '51qbjcfr72h62m06vtv5kkhgje';
+const ADDITIONAL_PROPERTY_NAME = 'sampleCreateId';
+const SUPER_EVENT_ID = '7k9ayl8hc';
+const LOCATION_BRANCH_CODE = '10';
+
+/**
+ * 識別子によるイベント管理サンプル
+ */
+// tslint:disable-next-line:max-func-body-length
+async function main() {
+    const authClient = await auth.login();
+    await authClient.refreshAccessToken();
+    const loginTicket = authClient.verifyIdToken({});
+    console.log('username is', loginTicket.getUsername());
+
+    const adminEventService = await (await client.loadCloudAdmin({
+        endpoint: <string>process.env.API_ADMIN_ENDPOINT,
+        auth: authClient
+    })).createEventInstance({
+        project: { id: PROJECT_ID },
+        seller: { id: SELLER_ID }
+    });
+
+    const today = moment()
+        .tz('Asia/Tokyo')
+        .format('YYYY-MM-DD');
+    const startDate = moment(`${today}T13:00:00Z`)
+        .toDate();
+    const endDate = moment(startDate)
+        .add(1, 'hour')
+        .toDate();
+    const validFrom = moment(`${today}T00:00:00+09:00`)
+        .toDate();
+    const validThrough = endDate;
+    const identifier = format(
+        '%s%s%s%s%s',
+        moment()
+            .tz('Asia/Tokyo')
+            .format('YYYYMMDD'),
+        'ABC',
+        '12345',
+        LOCATION_BRANCH_CODE,
+        moment(startDate)
+            .tz('Asia/Tokyo')
+            .format('HHmm')
+    );
+    console.log('creating if not exists...', identifier);
+
+    await adminEventService.createIfNotExistByIdentifier(
+        [
+            {
+                identifier,
+                doorTime: startDate,
+                startDate,
+                endDate,
+                eventStatus: client.factory.eventStatusType.EventScheduled,
+                additionalProperty: [
+                    {
+                        name: ADDITIONAL_PROPERTY_NAME,
+                        value: `fromSamples:${moment()
+                            .format('YYYY-MM-DD HH:mm')}`
+                    }
+                ],
+                offers: {
+                    eligibleQuantity: { maxValue: 6 },
+                    itemOffered: { id: EVENT_SERVICE_ID },
+                    seller: {
+                        makesOffer: [
+                            {
+                                typeOf: client.factory.offerType.Offer,
+                                availableAtOrFrom: { id: AVAILABLE_AT_OR_FROM_ID },
+                                availabilityStarts: validFrom,
+                                availabilityEnds: validThrough,
+                                validFrom,
+                                validThrough
+                            }
+                        ]
+                    }
+                }
+            }
+        ],
+        {
+            locationBranchCode: LOCATION_BRANCH_CODE,
+            superEventId: SUPER_EVENT_ID,
+            hasTicketedSeat: true,
+            typeOf: client.factory.eventType.ScreeningEvent
+        }
+    );
+    console.log('created.');
+
+    await adminEventService.updateEventsByIdentifier(
+        [
+            {
+                identifier,
+                doorTime: startDate,
+                startDate,
+                endDate,
+                eventStatus: client.factory.eventStatusType.EventCancelled,
+                additionalProperty: [
+                    {
+                        name: ADDITIONAL_PROPERTY_NAME,
+                        value: `update fromSamples:${moment()
+                            .format('YYYY-MM-DD HH:mm')}`
+                    }
+                ],
+                offers: {
+                    eligibleQuantity: { maxValue: 6 },
+                    itemOffered: { id: EVENT_SERVICE_ID },
+                    seller: {
+                        makesOffer: [
+                            {
+                                typeOf: client.factory.offerType.Offer,
+                                availableAtOrFrom: { id: AVAILABLE_AT_OR_FROM_ID },
+                                availabilityStarts: validFrom,
+                                availabilityEnds: validThrough,
+                                validFrom,
+                                validThrough
+                            }
+                        ]
+                    }
+                }
+            }
+        ],
+        {
+            typeOf: client.factory.eventType.ScreeningEvent
+        }
+    );
+    console.log('updated.');
+}
+
+main()
+    .then(() => {
+        console.log('success!');
+    })
+    .catch(console.error);

package/lib/abstract/chevre/categoryCode.d.ts

@@ -1,13 +1,22 @@
 import * as factory from '../factory';
 import { Service } from '../service';
+declare type IFindParams = Pick<factory.categoryCode.ISearchConditions, 'codeValue' | 'limit' | 'page'> & {
+    inCodeSet?: {
+        identifier?: {
+            $eq?: string;
+        };
+    };
+};
+declare type ICategoryCodeAsFindResult = Pick<factory.categoryCode.ICategoryCode, 'additionalProperty' | 'codeValue' | 'color' | 'image' | 'name' | 'typeOf'>;
 /**
  * 区分サービス
  */
 export declare class CategoryCodeService extends Service {
     /**
-     * 検索
+     * 区分検索(決済カード区分を除く)
      */
-    search(params: Omit<factory.categoryCode.ISearchConditions, 'project'>): Promise<{
-        data: factory.categoryCode.ICategoryCode[];
+    search(params: IFindParams): Promise<{
+        data: ICategoryCodeAsFindResult[];
     }>;
 }
+export {};

package/lib/abstract/chevre/categoryCode.js

@@ -63,7 +63,7 @@ var CategoryCodeService = /** @class */ (function (_super) {
         return _super !== null && _super.apply(this, arguments) || this;
     }
     /**
-     * 検索
+     * 区分検索(決済カード区分を除く)
      */
     CategoryCodeService.prototype.search = function (params) {
         return __awaiter(this, void 0, void 0, function () {

package/lib/abstract/chevreAdmin/event.d.ts

@@ -23,7 +23,7 @@ export declare type IUpdateParamsByIdentifier = Pick<factory.event.screeningEven
 export declare class EventService extends Service {
     /**
      * イベント冪等複数作成
-     * イベントコードをキーにして、存在しなければ作成する
+     * イベント識別子をキーにして、存在しなければ作成する
      */
     createIfNotExistByIdentifier(params: ICreateParamsByIdentifier[], options: {
         /**

package/lib/abstract/chevreAdmin/event.js

@@ -65,7 +65,7 @@ var EventService = /** @class */ (function (_super) {
     }
     /**
      * イベント冪等複数作成
-     * イベントコードをキーにして、存在しなければ作成する
+     * イベント識別子をキーにして、存在しなければ作成する
      */
     EventService.prototype.createIfNotExistByIdentifier = function (params, options) {
         return __awaiter(this, void 0, void 0, function () {

package/lib/abstract/chevreAdmin/note.d.ts

@@ -12,9 +12,9 @@ interface ICreateParams {
     text: string;
     about: {
         /**
-         * メモの主題リソースコード
+         * メモの主題リソースID
          */
-        identifier: string;
+        id: string;
     };
 }
 export interface IFindParams {
@@ -30,10 +30,6 @@ export interface IFindParams {
      * max: 10
      */
     aboutIds?: string[];
-    /**
-     * 主題リソースコードリスト
-     * max: 10
-     */
     /**
      * メモ識別子リスト
      * max: 10

package/lib/abstract/chevreAdmin/paymentService.d.ts

@@ -0,0 +1,62 @@
+import * as factory from '../factory';
+import { Service } from '../service';
+declare type IPaymentServiceAsFindResult = Pick<factory.service.paymentService.IService, 'additionalProperty' | 'description' | 'name' | 'productID' | 'serviceOutput' | 'serviceType' | 'typeOf'> & {
+    /**
+     * 決済サービスID
+     */
+    id: string;
+    project?: never;
+};
+export interface IFindParams {
+    /**
+     * max: 20
+     */
+    limit: number;
+    /**
+     * min: 1
+     */
+    page: number;
+    sortByProductID?: factory.sortType;
+    availableChannelId?: string;
+    id?: string;
+    ids?: string[];
+    nameRegex?: string;
+    productID?: string;
+    productIDs?: string[];
+    productIDRegex?: string;
+    /**
+     * プロバイダーに指定IDの販売者が含まれる
+     */
+    providerId?: string;
+    typeOf?: factory.service.paymentService.PaymentServiceType;
+    typeOfs?: factory.service.paymentService.PaymentServiceType[];
+    /**
+     * Invoice or Permit
+     */
+    serviceOutputTypeOf?: string;
+    /**
+     * 出力通貨区分コード
+     */
+    currencyType?: string;
+    /**
+     * 出力メンバーシップ区分コード
+     */
+    membershipType?: string;
+    /**
+     * 決済方法区分
+     */
+    paymentMethodType?: string;
+}
+/**
+ * 決済商品サービス
+ */
+export declare class PaymentProductService extends Service {
+    /**
+     * 決済サービス検索
+     * 公開属性のみ
+     * 管理者の決済サービス読取権限で使用可能
+     * 2025-10-18~
+     */
+    findPaymentServices(params: IFindParams): Promise<IPaymentServiceAsFindResult[]>;
+}
+export {};

package/lib/abstract/chevreAdmin/paymentService.js

@@ -0,0 +1,90 @@
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaymentProductService = void 0;
+var http_status_1 = require("http-status");
+var service_1 = require("../service");
+var BASE_URI = '/paymentServices';
+/**
+ * 決済商品サービス
+ */
+var PaymentProductService = /** @class */ (function (_super) {
+    __extends(PaymentProductService, _super);
+    function PaymentProductService() {
+        return _super !== null && _super.apply(this, arguments) || this;
+    }
+    /**
+     * 決済サービス検索
+     * 公開属性のみ
+     * 管理者の決済サービス読取権限で使用可能
+     * 2025-10-18~
+     */
+    PaymentProductService.prototype.findPaymentServices = function (params) {
+        return __awaiter(this, void 0, void 0, function () {
+            var _this = this;
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.fetch({
+                        uri: BASE_URI,
+                        method: 'GET',
+                        qs: params,
+                        expectedStatusCodes: [http_status_1.OK]
+                    })
+                        .then(function (response) { return __awaiter(_this, void 0, void 0, function () { return __generator(this, function (_a) {
+                        return [2 /*return*/, response.json()];
+                    }); }); })];
+            });
+        });
+    };
+    return PaymentProductService;
+}(service_1.Service));
+exports.PaymentProductService = PaymentProductService;

package/lib/abstract/chevreAdmin/product.d.ts

@@ -1,13 +1,105 @@
 import * as factory from '../factory';
 import { Service } from '../service';
-export declare type IProductWithoutCredentials = Omit<factory.product.IProduct, 'availableChannel'>;
-export declare type ISearchProductsResult = IProductWithoutCredentials;
+declare type IProductAsFindResult = Pick<factory.product.IProduct, 'description' | 'id' | 'name' | 'productID' | 'serviceOutput' | 'serviceType' | 'typeOf'> & {
+    /**
+     * プロダクトID
+     */
+    id: string;
+    project?: never;
+    hasOfferCatalog?: never;
+    additionalProperty?: never;
+};
+export interface IFindParams {
+    /**
+     * max: 20
+     */
+    limit: number;
+    /**
+     * min: 1
+     */
+    page: number;
+    sortByProductID?: factory.sortType;
+    id?: string;
+    ids?: string[];
+    typeOf?: factory.product.ProductType;
+    typeOfs?: factory.product.ProductType[];
+    /**
+     * カタログID
+     */
+    hasOfferCatalogId?: string;
+    /**
+     * 名称部分一致
+     */
+    nameRegex?: string;
+    /**
+     * プロダクトコード完全一致
+     */
+    productID?: string;
+    /**
+     * プロダクトコード部分一致
+     */
+    productIDRegex?: string;
+    /**
+     * 興行区分コード
+     */
+    serviceTypeCodeValue?: string;
+    /**
+     * ペイメントカードの場合、通貨区分
+     */
+    serviceOutputAmountCurrency?: string;
+    additionalPropertyName?: string;
+}
+interface IFindProductHasOfferCatalogParams {
+    /**
+     * max: 20
+     */
+    limit: number;
+    /**
+     * min: 1
+     */
+    page: number;
+    /**
+     * プロダクトIDリスト
+     */
+    itemOfferedIds?: string[];
+}
+interface IOfferCatalogAsFindResult {
+    /**
+     * カタログID
+     */
+    id: string;
+    /**
+     * 対象オファー
+     */
+    aggregateElement: {
+        itemOffered: {
+            /**
+             * プロダクトID
+             */
+            id: string;
+            typeOf: factory.product.ProductType;
+        };
+    };
+}
 /**
  * プロダクトサービス
  */
 export declare class ProductService extends Service {
     /**
      * プロダクトコードによる冪等置換
+     * 在庫管理ロールが必要
      */
     upsertByProductId(params: factory.product.ICreateParams[]): Promise<void>;
+    /**
+     * プロダクト検索
+     * 公開属性のみ
+     * 管理者のプロダクト読取権限で使用可能
+     * 2025-10-14~
+     */
+    findProducts(params: IFindParams): Promise<IProductAsFindResult[]>;
+    /**
+     * プロダクトオファーカタログ検索
+     */
+    findProductHasOfferCatalog(params: IFindProductHasOfferCatalogParams): Promise<IOfferCatalogAsFindResult[]>;
 }
+export {};